[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Communication and Design at Guix
From: |
swedebugia |
Subject: |
Re: Communication and Design at Guix |
Date: |
Thu, 10 Jan 2019 14:20:06 +0100 |
L p R n d n <address@hidden> skrev: (10 januari 2019 13:09:48 CET)
>Hello,
>
>Ludovic Courtès <address@hidden> writes:
>
>> Hi swedebugia,
>>
>> swedebugia <address@hidden> 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 address@hidden (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
- Communication and Design at Guix, L p R n d n, 2019/01/08
- Re: Communication and Design at Guix, Ludovic Courtès, 2019/01/08
- Re: Communication and Design at Guix, swedebugia, 2019/01/09
- Re: Communication and Design at Guix, Ludovic Courtès, 2019/01/09
- Re: Communication and Design at Guix, L p R n d n, 2019/01/10
- Re: Communication and Design at Guix,
swedebugia <=
- Re: Communication and Design at Guix, Ricardo Wurmus, 2019/01/10
- Re: Communication and Design at Guix, Ludovic Courtès, 2019/01/13
- Re: Communication and Design at Guix, L p R n d n, 2019/01/14
- Re: Communication and Design at Guix, zimoun, 2019/01/15
- Re: Communication and Design at Guix, nly, 2019/01/15
- Re: Communication and Design at Guix, Ricardo Wurmus, 2019/01/15
- Re: Communication and Design at Guix, Giovanni Biscuolo, 2019/01/16
- Re: Communication and Design at Guix, Ludovic Courtès, 2019/01/15
- Re: Communication and Design at Guix, swedebugia, 2019/01/14
- Re: Communication and Design at Guix, Ricardo Wurmus, 2019/01/15