>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 <[email protected]> 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.
