[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Communication and Design at Guix
From: |
Ludovic Courtès |
Subject: |
Re: Communication and Design at Guix |
Date: |
Tue, 15 Jan 2019 23:28:26 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) |
Hi,
L p R n d n <address@hidden> skribis:
[...]
>> I think it’s hard to generalize. What I do like about some GNU manuals
>> is that they’re well written and well structured; they can serve both as
>> a reference and as a way to get started. Examples of these include the
>> libc and the Emacs manuals. These are really book-quality, and are
>> actually published as such.
>
> Just to be clear, I was not talking about the content of the manuals. I'm
> in no position to judge their quality. And as you said, some are really good.
> I'm giving my opinion about the global layout, shape, css used in most
> of their manuals. I find them difficult to read (probably not true if
> you're used to them) because of things like contrast, lenght of lines
> etc. Without modifying the content, visual hints and helpers can really
> enhance the reading experience. Things like a left menu (as proposed by
> swedebugia) can be, IMHO, the difference between a read manual and an
> unread manual.
> WDYT?
Oh I agree with you: a better CSS would improve things (note that the
ugliest manuals you’ve seen on gnu.org don’t even have a CSS), and a
menu and visual hints would certainly help too.
>> I understand it’s a very different approach from what people do
>> nowadays, which is often more “quick-start” but also short-term-ish, but
>> I like the idea of working to help users understand what they’re doing,
>> as opposed to just throwing at them the minimum they need to know to get
>> things done. It’s about emancipating users, after all.
>
> I totally agree with you here. The goal must be to empower the user.
> But I also think manuals like we have and quickstart/cookbooks are not
> opposed but complementary. The latter are here to help people find their
> way without being overwhelmed by the quantity of information of a
> manual. The former really shines once a user has been introduced to the
> subject.
>
> For example, I think the packaging tutorial written by Pierre Neidhardt
> could really find its place in the documention (if the author agrees
> obviously). It's a nice *bridge* from guix user to guix hacker.
> Probably not in the manual but in a separate part of documentation.
> (how we separate them is another question).
> That kind of document can make the difference for a newcomer.
Maybe you’re right and that’s what I liked about Pierre’s tutorial. The
manual also has a “Defining Packages” section with similar goals, and I
like the idea of having introductory material like this directly in the
manual, but sometimes a separate and informal document can help too.
Thanks,
Ludo’.
- Re: Communication and Design at Guix, (continued)
- 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, 2019/01/10
- 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 <=
- Re: Communication and Design at Guix, swedebugia, 2019/01/14
- Re: Communication and Design at Guix, Ricardo Wurmus, 2019/01/15
- Re: Communication and Design at Guix, Julien Lepiller, 2019/01/15
- Re: Communication and Design at Guix, Ludovic Courtès, 2019/01/15
- Re: Communication and Design at Guix, L p R n d n, 2019/01/10
Re: Communication and Design at Guix, L p R n d n, 2019/01/10