Re: [patch] - Packaging guideline documentation update

[Pierre-Antoine Rault]

Cross-refs and a small glossary would help a lot to start with Guix. However, I 
was thinking about an explanation of folders, sub folders and main files as 
seen in the GNUnet manual [1].

[1] https://gnunet.org/book/export/html/37

Of course, these are just ideas to help brainstrom :)

- rigelk

address@hidden a écrit :

>Pierre-Antoine Rault <address@hidden> 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’.