From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id AFEAHYi2bV/rUwAA0tVLHw (envelope-from ) for ; Fri, 25 Sep 2020 09:21:12 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id 4AXZGIi2bV89fgAAB5/wlQ (envelope-from ) for ; Fri, 25 Sep 2020 09:21:12 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id AD7379404D5 for ; Fri, 25 Sep 2020 09:21:11 +0000 (UTC) Received: from localhost ([::1]:49710 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kLjuf-0001x8-Nf for larch@yhetil.org; Fri, 25 Sep 2020 05:21:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58598) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kLjuY-0001u1-8E for guix-patches@gnu.org; Fri, 25 Sep 2020 05:21:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:59323) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kLjuX-0000WE-Tr for guix-patches@gnu.org; Fri, 25 Sep 2020 05:21:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kLjuX-0006U6-Q7 for guix-patches@gnu.org; Fri, 25 Sep 2020 05:21:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43482] [PATCH 2/3] doc: Add the "Channels" section menu. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 25 Sep 2020 09:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43482 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: zimoun Cc: 43482@debbugs.gnu.org Received: via spool by 43482-submit@debbugs.gnu.org id=B43482.160102562624864 (code B ref 43482); Fri, 25 Sep 2020 09:21:01 +0000 Received: (at 43482) by debbugs.gnu.org; 25 Sep 2020 09:20:26 +0000 Received: from localhost ([127.0.0.1]:42636 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kLjty-0006Sy-5j for submit@debbugs.gnu.org; Fri, 25 Sep 2020 05:20:26 -0400 Received: from eggs.gnu.org ([209.51.188.92]:51548) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kLjtv-0006Sl-PM for 43482@debbugs.gnu.org; Fri, 25 Sep 2020 05:20:24 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:51457) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kLjtq-0000JO-Hg; Fri, 25 Sep 2020 05:20:18 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=60702 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kLjtp-0007N3-QM; Fri, 25 Sep 2020 05:20:18 -0400 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20200918014502.6081-1-zimon.toutoune@gmail.com> <20200918014502.6081-2-zimon.toutoune@gmail.com> <87ft778bx9.fsf@gnu.org> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 4 =?UTF-8?Q?Vend=C3=A9miaire?= an 229 de la =?UTF-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Fri, 25 Sep 2020 11:20:15 +0200 In-Reply-To: (zimoun's message of "Thu, 24 Sep 2020 17:05:24 +0200") Message-ID: <871riq43hs.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -3.3 (---) X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: -1.51 X-TUID: +2NgOR2roVVo Hi, zimoun skribis: > On Thu, 24 Sep 2020 at 16:52, Ludovic Court=C3=A8s wrote: > >> > +@node Channel Authentication >> > @subsection Channel Authentication >> >> What I had in mind was also to move everything one level higher: >> @section becomes @chapter, @subsection becomes @section, etc. > > I had that in mind too. After I did the change (subsection->section, > etc.), then I was not convinced, so I just added the '@node'. I think moving one level higher can help. More generally, I think it=E2=80= =99s a bad sign when a manual as few chapters and many subsubsubsections; it makes it harder to see what the main topics are. It=E2=80=99s a problem we= have here (the Guile manual is worse in that respect :-)). > However, moving "guix pull" and "guix time-machine" to this section > does not appear to me "logical" and should stay under Package > management. Especially with the "one level higher" move. WDYT? We=E2=80=99ll see that later. :-) Thanks, Ludo=E2=80=99.