guix-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Communication and Design at Guix


From: nly
Subject: Re: Communication and Design at Guix
Date: Tue, 15 Jan 2019 18:03:56 +0000

>As a newcomer, what lacks in the Guix documentation are concrete
examples and use cases.

continuing with the emacs example, a guixwiki.org would be awesome as an analog for emacswiki.org. User maintained, quick and short examples with lots of supporting links.

On January 15, 2019 10:36:20 AM UTC, zimoun <address@hidden> wrote:
Dear,

If I may, I would say that no manual can satisfy every reader; in
terms of rendering (menu, color, etc.) and in terms of content (deep
details or not, etc.).

About the rendering, some of us like to browse with Emacs and
info-mode, other prefer Web-style. There is no general pattern. :-)

About the content, I agree that the GNU manuals are intimidating for
newcomers because they are exhaustive, and the newcomers---as me---are
lost in all the details.
I also agree that someone often finds something in GNU manuals only if
they knows what they is looking for.
However, the GNU manuals are so useful once you are emancipated enough. :-)

An Introduction to Programming in Emacs Lisp spots well the different
kind of reader:
https://www.gnu.org/software/emacs/manual/html_node/eintr/Who-You-Are.html#Who-You-Are
It appears to me really a good companion to the heavy Elisp manual. I
mean one complements the other; depending on the reader's skills and
on they learns.

As a newcomer, what lacks in the Guix documentation are concrete
examples and use cases. They exist but they are scattered: blog post,
Pjotr's docs, etc.
A section with examples should be nice, e.g., some subsection as: Guix
for the impatient, Guix for the Web dev, Guix for the Scientific, Guix
for Pythonista, Guix for the Conda user, etc.
From my opinion, it is in the same direction than the effort about the
videos (current outreachy); if I am understanding well.


All the best,
simon


--
Sent from my Android device with K-9 Mail. Please excuse my brevity.
reply via email to

[Prev in Thread] Current Thread [Next in Thread]