From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id yOhLJhtAYl/EAwAA0tVLHw (envelope-from ) for ; Wed, 16 Sep 2020 16:40:59 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id kFhFIhtAYl+OagAA1q6Kng (envelope-from ) for ; Wed, 16 Sep 2020 16:40:59 +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 5F6E59401D0 for ; Wed, 16 Sep 2020 16:40:59 +0000 (UTC) Received: from localhost ([::1]:40484 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kIaUM-0006F1-Bq for larch@yhetil.org; Wed, 16 Sep 2020 12:40:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57638) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kIaTR-0005r6-BR for guix-devel@gnu.org; Wed, 16 Sep 2020 12:40:01 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44646) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kIaTR-0003C8-0w; Wed, 16 Sep 2020 12:40:01 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=39794 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kIaTQ-0001YN-IS; Wed, 16 Sep 2020 12:40:00 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: zimoun Subject: Re: doc: Channel subsection order? References: X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: Jour de la Vertu de =?utf-8?Q?l'Ann=C3=A9e?= 228 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: Wed, 16 Sep 2020 18:39:47 +0200 In-Reply-To: (zimoun's message of "Sat, 12 Sep 2020 00:49:34 +0200") Message-ID: <87een1n0a4.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-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Guix Devel Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Spam-Score: -0.01 X-TUID: LRT/EDqytC3Q Hi! zimoun skribis: > I was re-reading the section about Channels and the subsections do not > appear to me "logical". Currently, it is: > > 1. Channel Authentication > 2. Using a Custom Guix Channel > 3. Specifying Additional Channels > 4. Declaring Channel Dependencies > 5. Package Modules in a Sub-directory > 6. Specifying Channel Authorizations > 7. Primary URL > 8. Writing Channel News > 9. Replicating Guix > > and to me, the progression when reading is smoother with this order: > > 1. Using a Custom Guix Channel > 2. Specifying Additional Channels > 3. Channel Authentication > 4. Declaring Channel Dependencies > etc. Yes, I agree! I think we should: 1. Move =E2=80=9CChannels=E2=80=9D to the top level, with real subsection= s as nodes. 2. Clearly distinguish between using a channel and developing a channel. The former should come first. 3. Probably move =E2=80=98guix pull=E2=80=99 and =E2=80=98guix time-machi= ne=E2=80=99 under that section. 4. Add a tutorial-like section on how to work on your own channel. Thoughts? Ludo=E2=80=99.