From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 02 05:50:30 2020 Received: (at 43159) by debbugs.gnu.org; 2 Sep 2020 09:50:30 +0000 Received: from localhost ([127.0.0.1]:58364 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDPPR-0007E5-N5 for submit@debbugs.gnu.org; Wed, 02 Sep 2020 05:50:30 -0400 Received: from eggs.gnu.org ([209.51.188.92]:58814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kDPPP-0007Di-AZ for 43159@debbugs.gnu.org; Wed, 02 Sep 2020 05:50:28 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42365) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kDPPJ-00075b-CU; Wed, 02 Sep 2020 05:50:21 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=53528 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kDPPI-0005gD-Ki; Wed, 02 Sep 2020 05:50:21 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Efraim Flashner Subject: Re: [bug#43159] [PATCH 0/2] Make 'guix help' helpful References: <20200901203520.21103-1-ludo@gnu.org> <20200902080622.GI856@E5400> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 17 Fructidor an 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, 02 Sep 2020 11:50:17 +0200 In-Reply-To: <20200902080622.GI856@E5400> (Efraim Flashner's message of "Wed, 2 Sep 2020 11:06:22 +0300") Message-ID: <87a6y87bja.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 43159 Cc: 43159@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hi, Efraim Flashner skribis: > On Tue, Sep 01, 2020 at 10:35:20PM +0200, Ludovic Court=C3=A8s wrote: >> Hey Guix! >>=20 >> Here=E2=80=99s another long-overdue change that was brought to my >> attention: making =E2=80=98guix help=E2=80=99 show a synopsis of each co= mmand. >> While at it, it also groups them in categories (I more or >> less followed the manual, but there=E2=80=99s prolly room for >> improvement, like a =E2=80=98packaging=E2=80=99 category maybe?): >>=20 > > I dislike the idea that some commands are only for developers and some > commands are "too advanced for the common user" (my words, not yours). Yeah, I=E2=80=99m ambivalent about this as well. > Before bikeshedding about where the options should be, how about: > commands for developers -> commands related to building Rather, =E2=80=9Ccommands for development=E2=80=9C, because that=E2=80=99s = really what =E2=80=98guix environment=E2=80=99 is about, for instance, but saying =E2=80=98developmen= t=E2=80=99 rather than =E2=80=98developers=E2=80=99 is probably wise. > advanced usage -> commands related to verification Well that only works for =E2=80=98challenge=E2=80=99 (which I=E2=80=99d lik= e to put in the hands of =E2=80=98normal=E2=80=99 users, so I=E2=80=99m not comfortable with the = =E2=80=98advanced=E2=80=99 label, but OTOH, it=E2=80=99s clearly not one of the commands you=E2=80=99d begin with= .) What about archive, copy, download, etc.? > This way they're still "commands for everybody" and they're more > descriptive than just "advanced" "expert" and "debug" style headers. Understood. Thanks for your feedback! Ludo=E2=80=99.