From mboxrd@z Thu Jan 1 00:00:00 1970 From: zimoun Subject: Re: Communication and Design at Guix Date: Tue, 15 Jan 2019 11:36:20 +0100 Message-ID: References: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> <877efd1p56.fsf@gnu.org> <87r2dk4m4g.fsf@elephly.net> <87k1j81bau.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:48667) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gjM5K-0003mm-UZ for guix-devel@gnu.org; Tue, 15 Jan 2019 05:36:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gjM5J-0001Ay-U2 for guix-devel@gnu.org; Tue, 15 Jan 2019 05:36:42 -0500 Received: from mail-qt1-x82b.google.com ([2607:f8b0:4864:20::82b]:44470) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gjM5J-0000yj-LN for guix-devel@gnu.org; Tue, 15 Jan 2019 05:36:41 -0500 Received: by mail-qt1-x82b.google.com with SMTP id n32so2322925qte.11 for ; Tue, 15 Jan 2019 02:36:32 -0800 (PST) In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: L p R n d n Cc: Guix Devel 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