On Tue, Sep 8, 2015 at 5:54 AM, Ludovic Courtès <l...@gnu.org> wrote: > Hi, > > Craig Barnes <cjbarne...@gmail.com> skribis: > >> Some time ago I asked on IRC about a guix users wiki. Someone suggest >> that I propose one here (sorry it's taken so long). >> >> I think that a wiki would be a good complement to the manual, which >> while quite complete, lacks exhaustive examples (which would be >> impractical). > > I have mixed feelings. There are several issues with a Wiki: one can > hardly know which version of the software it’s talking about (whereas > the installed Info pages of PDFs necessarily match the installed > version), and more importantly, it tends to be disorganized, > unmaintained, and often misleading. > > I would strongly encourage people to help fix the manual as a first > step. If information that a user deems useful is missing from the > manual, then it’s a bug. I’m willing to make it as simple as possible > to fix the manual. But really, the manual should have all the examples > necessary for people to understand how to tweak things.
+1 - Dave