[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <87ednwndm6.fsf@meer.lwn.net>
Date: Thu, 04 May 2023 12:41:21 -0600
From: Jonathan Corbet <corbet@....net>
To: Costa Shulyupin <costa.shul@...hat.com>,
Mauro Carvalho Chehab <mchehab@...nel.org>,
linux-doc@...r.kernel.org
Cc: Costa Shulyupin <costa.shul@...hat.com>,
Vineet Gupta <vgupta@...nel.org>,
Jonas Bonn <jonas@...thpole.se>,
Stefan Kristiansson <stefan.kristiansson@...nalahti.fi>,
Stafford Horne <shorne@...il.com>,
"James E.J. Bottomley" <James.Bottomley@...senPartnership.com>,
Helge Deller <deller@....de>,
Yoshinori Sato <ysato@...rs.sourceforge.jp>,
Rich Felker <dalias@...c.org>,
John Paul Adrian Glaubitz <glaubitz@...sik.fu-berlin.de>,
Thomas Gleixner <tglx@...utronix.de>,
Ingo Molnar <mingo@...hat.com>, Borislav Petkov <bp@...en8.de>,
Dave Hansen <dave.hansen@...ux.intel.com>,
"maintainer:X86 ARCHITECTURE (32-BIT AND 64-BIT)" <x86@...nel.org>,
"H. Peter Anvin" <hpa@...or.com>,
Yanteng Si <siyanteng@...ngson.cn>,
Geert Uytterhoeven <geert@...ux-m68k.org>,
Max Filippov <jcmvbkbc@...il.com>,
"open list:SYNOPSYS ARC ARCHITECTURE"
<linux-snps-arc@...ts.infradead.org>,
open list <linux-kernel@...r.kernel.org>,
"open list:IA64 (Itanium) PLATFORM" <linux-ia64@...r.kernel.org>,
"open list:OPENRISC ARCHITECTURE" <linux-openrisc@...r.kernel.org>,
"open list:PARISC ARCHITECTURE" <linux-parisc@...r.kernel.org>,
"open list:SUPERH" <linux-sh@...r.kernel.org>
Subject: Re: [PATCH v3] docs: directive `alias` for redirects
Costa Shulyupin <costa.shul@...hat.com> 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@...hat.com>
>
> ---
>
> 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
Powered by blists - more mailing lists