From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andreas Enge Subject: Manual structure Date: Sat, 5 Mar 2016 16:42:45 +0100 Message-ID: <20160305154245.GA25307@solar> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46656) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acEM1-0001bQ-Kb for guix-devel@gnu.org; Sat, 05 Mar 2016 10:42:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1acELy-0003sz-Ep for guix-devel@gnu.org; Sat, 05 Mar 2016 10:42:53 -0500 Received: from mailrelay6.public.one.com ([91.198.169.200]:35293) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acELy-0003sq-3E for guix-devel@gnu.org; Sat, 05 Mar 2016 10:42:50 -0500 Content-Disposition: inline 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-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: guix-devel@gnu.org Hello, I would like to suggest moving some chapters and sections around in the manual. For keeping this short, I will refer to the section numbers. My main motivation are the four digits now denoting subsections in 7; this is an indication that we are putting too much into this chapter. Notice that this chapter, "GNU Distribution", has been introduced in the beginning to speak about the packages of Guix; now it is more concerned with GuixSD. Loosely speaking, I would like to strip off the highest level of 7 and make subchapters of 7.1, 7.2 and so on. Moreover, I see the manual as having three big parts: - introduction (chapter 1, well, so is is rather small) - Guix (chapters 2-6 and 7.3-7.8) - GuixSD (chapters 7.1 and 7.2) I did not think about 8 and where it belongs. Concretely, I suggest the following: - Rename "7.6 Packaging Guidelines" to "Packages", and move it one level up between the current 6 and 7 as the new chapter 7. Somehow integrate 7.3 to 7.8 here. - Move 7.1 and 7.2 to new chapters 8 and 9. What do you think? Changing the layout is made more difficult by the fact that all menus are hand-coded; do I remember wrongly that this can be done automatically in texinfo? If yes, it would be easier to make such a change first. Andreas