From mboxrd@z Thu Jan 1 00:00:00 1970 From: nly Subject: Re: Communication and Design at Guix Date: Tue, 15 Jan 2019 18:03:56 +0000 Message-ID: <32DFF401-F4E7-4B98-A8B2-DC9A321500D7@disroot.org> 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: multipart/alternative; boundary="----4WA92PX3USEPGFL7NCRDM028LLGJMR" Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([209.51.188.92]:43481) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gjT4m-0006hZ-3N for guix-devel@gnu.org; Tue, 15 Jan 2019 13:04:39 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gjT4e-0004jk-A2 for guix-devel@gnu.org; Tue, 15 Jan 2019 13:04:32 -0500 Received: from knopi.disroot.org ([178.21.23.139]:54806) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gjT4L-0004ah-TD for guix-devel@gnu.org; Tue, 15 Jan 2019 13:04:16 -0500 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: zimoun , L p R n d n Cc: Guix Devel ------4WA92PX3USEPGFL7NCRDM028LLGJMR Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable >As a newcomer, what lacks in the Guix documentation are concrete examples and use cases=2E continuing with the emacs example, a guixwiki=2Eorg would be awesome as an= analog for emacswiki=2Eorg=2E User maintained, quick and short examples wi= th lots of supporting links=2E On January 15, 2019 10:36:20 AM UTC, zimoun = wrote: >Dear, > >If I may, I would say that no manual can satisfy every reader; in >terms of rendering (menu, color, etc=2E) and in terms of content (deep >details or not, etc=2E)=2E > >About the rendering, some of us like to browse with Emacs and >info-mode, other prefer Web-style=2E There is no general pattern=2E :-) > >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=2E >I also agree that someone often finds something in GNU manuals only if >they knows what they is looking for=2E >However, the GNU manuals are so useful once you are emancipated enough=2E >:-) > >An Introduction to Programming in Emacs Lisp spots well the different >kind of reader: >https://www=2Egnu=2Eorg/software/emacs/manual/html_node/eintr/Who-You-Are= =2Ehtml#Who-You-Are >It appears to me really a good companion to the heavy Elisp manual=2E I >mean one complements the other; depending on the reader's skills and >on they learns=2E > >As a newcomer, what lacks in the Guix documentation are concrete >examples and use cases=2E They exist but they are scattered: blog post, >Pjotr's docs, etc=2E >A section with examples should be nice, e=2Eg=2E, some subsection as: Gui= x >for the impatient, Guix for the Web dev, Guix for the Scientific, Guix >for Pythonista, Guix for the Conda user, etc=2E >From my opinion, it is in the same direction than the effort about the >videos (current outreachy); if I am understanding well=2E > > >All the best, >simon --=20 Sent from my Android device with K-9 Mail=2E Please excuse my brevity=2E ------4WA92PX3USEPGFL7NCRDM028LLGJMR Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable >As a newcomer, what lacks in the Guix document= ation are concrete
examples and use cases=2E

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

On January 15, 2019 10:36:20 AM= UTC, zimoun <zimon=2Etoutoune@gmail=2Ecom> wrote:
Dear,

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

About the re=
ndering, some of us like to browse with Emacs and
info-mode, other prefe=
r Web-style=2E There is no general pattern=2E :-)

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

An Introduction =
to Programming in Emacs Lisp spots well the different
kind of reader:https://www=2Egnu=2Eorg/software/emacs/manua=
l/html_node/eintr/Who-You-Are=2Ehtml#Who-You-Are
It appears to me re=
ally a good companion to the heavy Elisp manual=2E I
mean one complement=
s the other; depending on the reader's skills and
on they learns=2E
<=
br>As a newcomer, what lacks in the Guix documentation are concrete
exam=
ples and use cases=2E They exist but they are scattered: blog post,
Pjot=
r's docs, etc=2E
A section with examples should be nice, e=2Eg=2E, some =
subsection as: Guix
for the impatient, Guix for the Web dev, Guix for th=
e Scientific, Guix
for Pythonista, Guix for the Conda user, etc=2E
Fr=
om my opinion, it is in the same direction than the effort about the
vid=
eos (current outreachy); if I am understanding well=2E


All the b=
est,
simon


--
Sent from my Andro= id device with K-9 Mail=2E Please excuse my brevity=2E ------4WA92PX3USEPGFL7NCRDM028LLGJMR--