Re: Communication and Design at Guix

[Ricardo Wurmus]

L p R n d n <address@hidden> writes:

>>> What about guix.info? We can do whatever we want there I suppose and just 
>>> link
>>> to it from the gnu site.
>>
>> Well in general we can always do whatever we want.  :-)  I do think
>> there’s value in presenting GNU manuals in a consistent way, though,
>> especially since Guix’ manual has cross-references to many other
>> manuals.
>
> That would be nice though. Even if consistency is enjoyable, I think
> the benefits of a nicely shaped and organised documentation easily beat
> what we could get from being consistent with non-Guix manuals. IMHO
> GNU manuals are ok when you know what you're searching for, I find them
> unreadable. + I think they're intimidating for newcomers. :/

It’s fine to deviate from the consistent style.  We do that already for
the style sheet that’s used for our HTML documentation.  Compare this:

    https://www.gnu.org/software/sharutils/manual/html_node/index.html

with this:

    https://www.gnu.org/software/guix/manual/en/html_node/index.html

It’s fine to change our style sheet, but let’s stay with Texinfo.

--
Ricardo