Re: [PATCH v3] docs: directive `alias` for redirects
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
- To: Costa Shulyupin <costa.shul@xxxxxxxxxx>, Mauro Carvalho Chehab <mchehab@xxxxxxxxxx>, linux-doc@xxxxxxxxxxxxxxx
- Subject: Re: [PATCH v3] docs: directive `alias` for redirects
- From: Jonathan Corbet <corbet@xxxxxxx>
- Date: Thu, 04 May 2023 12:41:21 -0600
- Cc: Costa Shulyupin <costa.shul@xxxxxxxxxx>, Vineet Gupta <vgupta@xxxxxxxxxx>, Jonas Bonn <jonas@xxxxxxxxxxxx>, Stefan Kristiansson <stefan.kristiansson@xxxxxxxxxxxxx>, Stafford Horne <shorne@xxxxxxxxx>, "James E.J. Bottomley" <James.Bottomley@xxxxxxxxxxxxxxxxxxxxx>, Helge Deller <deller@xxxxxx>, Yoshinori Sato <ysato@xxxxxxxxxxxxx>, Rich Felker <dalias@xxxxxxxx>, John Paul Adrian Glaubitz <glaubitz@xxxxxxxxxxxxxxxxxxx>, Thomas Gleixner <tglx@xxxxxxxxxxxxx>, Ingo Molnar <mingo@xxxxxxxxxx>, Borislav Petkov <bp@xxxxxxxxx>, Dave Hansen <dave.hansen@xxxxxxxxxxxxxxx>, "maintainer:X86 ARCHITECTURE (32-BIT AND 64-BIT)" <x86@xxxxxxxxxx>, "H. Peter Anvin" <hpa@xxxxxxxxx>, Yanteng Si <siyanteng@xxxxxxxxxxx>, Geert Uytterhoeven <geert@xxxxxxxxxxxxxx>, Max Filippov <jcmvbkbc@xxxxxxxxx>, "open list:SYNOPSYS ARC ARCHITECTURE" <linux-snps-arc@xxxxxxxxxxxxxxxxxxx>, open list <linux-kernel@xxxxxxxxxxxxxxx>, "open list:IA64 (Itanium) PLATFORM" <linux-ia64@xxxxxxxxxxxxxxx>, "open list:OPENRISC ARCHITECTURE" <linux-openrisc@xxxxxxxxxxxxxxx>, "open list:PARISC ARCHITECTURE" <linux-parisc@xxxxxxxxxxxxxxx>, "open list:SUPERH" <linux-sh@xxxxxxxxxxxxxxx>
- In-reply-to: <20230504180210.727364-1-costa.shul@redhat.com>
- References: <20230504180210.727364-1-costa.shul@redhat.com>
Costa Shulyupin <costa.shul@xxxxxxxxxx> writes:
> and several redirects for moved main arch pages
>
> Problems:
> - The documentation lacks hierarchy
> - Relocating pages disrupts external links to
> the documentation and causes confusion for users
>
> Benefits:
> - Users can easily access relocated pages from external resources
> - Using redirects frees up options for reorganizing the documentation
>
> The solution:
> - Introduced directive `alias` which declares previous path of
> a moved document as the argument.
> - Redirects are implemented with Sphinx extension rediraffe_redirects.
>
> Signed-off-by: Costa Shulyupin <costa.shul@xxxxxxxxxx>
>
> ---
>
> Changes:
> - complete new implementation
I honestly don't know why you keep throwing versions of this at us. In
the absence of observed problems, I don't see the value in adding
infrastructure that we have to maintain going forward.
Please stop with this for now.
Thanks,
jon
[Index of Archives]
[Linux Kernel]
[Sparc Linux]
[DCCP]
[Linux ARM]
[Yosemite News]
[Linux SCSI]
[Linux x86_64]
[Linux for Ham Radio]