Re: Communication and Design at Guix

[zimoun <zimon.toutoune@gmail.com>]

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