Re: [patch] - Packaging guideline documentation update

[ludo@gnu.org (Ludovic Courtès)]

Pierre-Antoine Rault <par@rigelk.eu> skribis:

> On 10/03/2014 21:56, Ludovic Courtès wrote:
>> I’ve applied a stripped-down version of the patch: I ended up
>> removing “Packaging 101” because it was redundant with the
>> “Packaging Guidelines” section of the manual, so I moved the
>> missing bits in that section (info "(guix) Packaging Guidelines").
>> I also removed details about how ‘git format-patch’ and co. work,
>> because these commands already have their own manual.
>
> I admit it was overkill :)
>
>> I realize the manual can be improved when it comes to introductory
>> material.
>
> I would think of a (not so) short explaination of the guix tree as
> seen in the GNUnet manuel, for instance. What do you think ?

Hmm, perhaps.  Actually, part of the module name space is described here
in there.  For instance (gnu packages ...) is described under “Package
Modules”, (guix build ...) is described under “Derivations”, etc.
Perhaps a new section with cross-refs to these would help?

Ludo’.