Re: [patch] - Packaging guideline documentation update

[Ludovic Courtès]

Hi,

Pierre-Antoine Rault <address@hidden> skribis:

> Attached is a patch with basic explaination most of you know by heart,
> but that may not be obvious for newbies (like me). The details
> provided to the doc and hacking file both cover packaging and how to
> avoid the main pitfalls I've encountered myself recently. Most of them
> are based on advice from Dave, Mark_weaver (on #guix), these slides:
> http://www.gnu.org/software/guix/guix-ghm-andreas-20130823.pdf and
> these commands
> http://lists.gnu.org/archive/html/guix-devel/2013-12/msg00079.html
>
> What do you think ? Are there things to add ? (of course there are !)

Thanks for the patch!

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").  If you see anything still missing
there, please do let me know; this should be the canonical place for
such introductory material.

I also removed details about how ‘git format-patch’ and co. work,
because these commands already have their own manual.

I realize the manual can be improved when it comes to introductory
material.  If you think of other improvements, please let’s make them in
the “Packaging Guidelines” and “Defining Packages” sections.

Thanks,
Ludo’.