From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id F1A66C7EE2A for ; Thu, 4 May 2023 18:41:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229940AbjEDSlc (ORCPT ); Thu, 4 May 2023 14:41:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40964 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229535AbjEDSl3 (ORCPT ); Thu, 4 May 2023 14:41:29 -0400 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2973D4C22; Thu, 4 May 2023 11:41:24 -0700 (PDT) Received: from localhost (mdns.lwn.net [45.79.72.68]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 567092C8; Thu, 4 May 2023 18:41:22 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 567092C8 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1683225682; bh=M+B8SLm2PMpcta7Rti3FG8GJchHOrmHgx3npRi99b0I=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=D8F8e1r5FZCihfpZZlw2+z+byrsjbVr+sas/C2TEgJm3BqSuhVyHZ93EDR0L3qJTA P6h8rPVfEpJKtEzLiApFxuSMAAeF243cOrEEci9zk8bbKSUZeuDt4eQESBOUNT7puk mcBaITpCCjH0tMh5lfSNvPxn/gj3KJiHwmeEFFxbga4pQT7UvWVVdUyvN/N+R8CZk2 K1/gTctWIWUzf+eWgjq7fi02VApwtsOvabN3M+6TlCSXmtFPmlX6X7bBmQHH8eJPHx DY5c4bbfCkBT3czlY9m3tBy1sNxrvfQgQwZGyHgBqvRGx6MV5VtVx1c0F6Z4bLwzOH rHTIezs2tF/SQ== From: Jonathan Corbet To: Costa Shulyupin , Mauro Carvalho Chehab , linux-doc@vger.kernel.org Cc: Costa Shulyupin , Vineet Gupta , Jonas Bonn , Stefan Kristiansson , Stafford Horne , "James E.J. Bottomley" , Helge Deller , Yoshinori Sato , Rich Felker , John Paul Adrian Glaubitz , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , "maintainer:X86 ARCHITECTURE (32-BIT AND 64-BIT)" , "H. Peter Anvin" , Yanteng Si , Geert Uytterhoeven , Max Filippov , "open list:SYNOPSYS ARC ARCHITECTURE" , open list , "open list:IA64 (Itanium) PLATFORM" , "open list:OPENRISC ARCHITECTURE" , "open list:PARISC ARCHITECTURE" , "open list:SUPERH" Subject: Re: [PATCH v3] docs: directive `alias` for redirects In-Reply-To: <20230504180210.727364-1-costa.shul@redhat.com> References: <20230504180210.727364-1-costa.shul@redhat.com> Date: Thu, 04 May 2023 12:41:21 -0600 Message-ID: <87ednwndm6.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Costa Shulyupin 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 > > --- > > 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