L p R n d n <[email protected]> skrev: (10 januari 2019 13:09:48 CET) >Hello, > >Ludovic Courtès <[email protected]> writes: > >> Hi swedebugia, >> >> swedebugia <[email protected]> skribis: >> >>>>> By the way, I wanted to start working on the documentation. >>>>> IMHO, it might benefit from a little graphical enhancement for >>>>> newcomers. The thing is that it's currently hosted on >>>>> gnu.org so it's probably not possible to modify the design. So I >>>>wanted >>>>> to ask, first, if that's something that would be welcome? What >could >>>>be >>>>> the possibilities? And what would be the technical limitations? >>>> >>>>The HTML pages at gnu.org/s/guix/manual are generated from Texinfo. >>>>The >>>>CSS there is shared with all the GNU manuals, which is nice for >>>>consistency. Ideally modifications of the CSS would be submitted to >>>>the >>>>GNU webmaster or [email protected] (I forgot which one). However, >be >>>>aware that you may encounter misplaced conservatism if you take that >>>>route, so don’t lose your hair on it. >> >> [...] >> >>> 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. :/
I agree with you to some degree. I like the design of both the racket documentation and readthedocs. Especially the left menu gives a nice overview and searchability on page is also nice. -- Sent from my p≡p for Android.
pEpkey.asc
Description: application/pgp-keys
