From mboxrd@z Thu Jan 1 00:00:00 1970 From: sirgazil Subject: Re: Reworking the cookbook layout Date: Wed, 27 Nov 2019 09:21:38 -0500 Message-ID: <16ead3d2f0d.ea38287f35141.5430744128116415142@zoho.com> References: <20191126231136.212ff31e@sybil.lepiller.eu> <878so1livx.fsf@ambrevar.xyz> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:42727) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iZyCT-0000h9-NZ for guix-devel@gnu.org; Wed, 27 Nov 2019 09:21:50 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iZyCS-00014N-JH for guix-devel@gnu.org; Wed, 27 Nov 2019 09:21:49 -0500 Received: from sender4-pp-o94.zoho.com ([136.143.188.94]:25443) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iZyCS-00010y-9D for guix-devel@gnu.org; Wed, 27 Nov 2019 09:21:48 -0500 In-Reply-To: <878so1livx.fsf@ambrevar.xyz> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Pierre Neidhardt Cc: Julien Lepiller , guix-devel ---- On Wed, 27 Nov 2019 05:21:22 -0500 Pierre Neidhardt wrote ---- > No strong opinion here, it seems to be a good idea. > > My only current itch with the cookbook is that it might have too deep a > hierarchy. Personally, I prefer to put the @menu before the @contents because the former works as an overview and the latter is intimidating. I don't know why it is done the other way around in many GNU manuals, though.