Andreas Enge <andr...@enge.fr> 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)