From mboxrd@z Thu Jan 1 00:00:00 1970 From: myglc2 Subject: Re: Manual structure Date: Sat, 05 Mar 2016 23:17:21 -0500 Message-ID: <87pov8fdf2.fsf@gmail.com> References: <20160305154245.GA25307@solar> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:41076) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acQ6g-0008OF-T4 for guix-devel@gnu.org; Sat, 05 Mar 2016 23:15:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1acQ6b-0005jL-U7 for guix-devel@gnu.org; Sat, 05 Mar 2016 23:15:50 -0500 Received: from plane.gmane.org ([80.91.229.3]:51951) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acQ6b-0005jA-NV for guix-devel@gnu.org; Sat, 05 Mar 2016 23:15:45 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1acQ6Z-0007ba-Sj for guix-devel@gnu.org; Sun, 06 Mar 2016 05:15:44 +0100 Received: from c-73-167-118-254.hsd1.ma.comcast.net ([73.167.118.254]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 06 Mar 2016 05:15:43 +0100 Received: from myglc2 by c-73-167-118-254.hsd1.ma.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 06 Mar 2016 05:15:43 +0100 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 Andreas Enge writes: [...] > 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? Great idea. While you are at it, please consider additional changes to reorganize sections by package management vs system configuration and users vs coders, perhaps along the lines shown below. Current section numbers in ()'s. * GNU GUIX Ref Man ** intro (1) ** Using Guix package management (3.1) *** Installation **** from Binary (2.1) **** from Source (2.2, 2.3, 2.4, 2.5) *** Package Management **** Application Setup (2.6) **** Package Management (3, 7.4) ** Using Guix System Distribution (7) *** Installation **** By USB (7.1) **** Converting Guix to GuixSD (TK) *** System Configuration (7.2) ** Using Guix Commands (6, 7.2.13) ** Using the Guix in Emacs (4) ** Coding in Guix *** Building from Git (8.1, 8.2, 8.3) *** programming interface (5) *** packaging guidelines (7.5, 7.6) *** system configuration (7.7, 7.8) *** submitting code (8.4, 8.5) *** debugging (7.3) ** acknowledgements ** appendix ** concept index ** programming index ** glossary (TK)