L p R n d n <[email protected]> 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
