GNU bug report logs - #34156
[PATCH 0/4] Re-organize the manual

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Ludovic Courtès <ludo <at> gnu.org>
Subject: bug#34156: closed (Re: [bug#34156] [PATCH 0/4] Re-organize the
 manual)
Date: Tue, 22 Jan 2019 22:21:02 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#34156: [PATCH 0/4] Re-organize the manual

which was filed against the guix-patches package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 34156 <at> debbugs.gnu.org.

-- 
34156: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=34156
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Ludovic Courtès <ludo <at> gnu.org>
To: 34156-done <at> debbugs.gnu.org
Subject: Re: [bug#34156] [PATCH 0/4] Re-organize the manual
Date: Tue, 22 Jan 2019 23:20:33 +0100

Ludovic Courtès <ludo <at> gnu.org> skribis:

>   doc: Move sections under "GNU Distribution" one level higher.
>   doc: Move "System Installation" right after "Installation".
>   doc: Move "Packaging Guidelines" under "Contributing".
>   doc: Move "Package Modules" under "Programming Interface".

Ricardo and Julien were almost enthusiastic about this change on IRC
;-), so I’ve just pushed it.

Ludo’.

[Message part 3 (message/rfc822, inline)]

From: Ludovic Courtès <ludo <at> gnu.org>
To: guix-patches <at> gnu.org
Cc: Ludovic Courtès <ludo <at> gnu.org>
Subject: [PATCH 0/4] Re-organize the manual
Date: Mon, 21 Jan 2019 11:47:41 +0100

Hello Guix!

This is the great season cleanup of the manual.  I think it provides
a clearer view of what’s available.  Until now, the top-level chapters
were:

--8<---------------cut here---------------start------------->8---
* Introduction::                What is Guix about?
* Installation::                Installing Guix.
* Package Management::          Package installation, upgrade, etc.
* Programming Interface::       Using Guix in Scheme.
* Utilities::                   Package management commands.
* GNU Distribution::            Software for your friendly GNU system.
* Contributing::                Your help needed!
--8<---------------cut here---------------end--------------->8---

With these changes, that becomes:

--8<---------------cut here---------------start------------->8---
* Introduction::                What is Guix about?
* Installation::                Installing Guix.
* System Installation::         Installing the whole operating system.
* Package Management::          Package installation, upgrade, etc.
* Programming Interface::       Using Guix in Scheme.
* Utilities::                   Package management commands.
* System Configuration::        Configuring the operating system.
* Documentation::               Browsing software user manuals.
* Installing Debugging Files::  Feeding the debugger.
* Security Updates::            Deploying security fixes quickly.
* Bootstrapping::               GNU/Linux built from scratch.
* Porting::                     Targeting another platform or kernel.
* Contributing::                Your help needed!
--8<---------------cut here---------------end--------------->8---

Things about “the distro” in a broad sense are no longer hidden
under “GNU Distribution” and the introduction no longer ignores
Guix System.

Next up I’d like us to get rid of these catch-all “Utilities”
section and instead organize things by activities, such as
“Development”, “Distributing Substitutes”, and “Managing Storage
Space”.

Later I’d like to move each chapter to its own .texi file, which
will be nicer and will help Emacs build menus (currently it’s
confused because only one chapter leaves in a separate file.)

Thoughts?

Ludo’.

Ludovic Courtès (4):
  doc: Move sections under "GNU Distribution" one level higher.
  doc: Move "System Installation" right after "Installation".
  doc: Move "Packaging Guidelines" under "Contributing".
  doc: Move "Package Modules" under "Programming Interface".

 doc/contributing.texi |  450 ++++++++
 doc/guix.texi         | 2254 ++++++++++++++++-------------------------
 2 files changed, 1336 insertions(+), 1368 deletions(-)

-- 
2.20.1

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.