From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: Reference manual + tutorials Date: Tue, 29 May 2018 21:38:37 +0200 Message-ID: <87muwiuu9u.fsf@gnu.org> References: <87h8mu1lv9.fsf@gnu.org> <87muwk2fok.fsf@gmail.com> <87h8mshvdz.fsf@elephly.net> <87lgc2r31y.fsf@elephly.net> <87h8mqqzle.fsf@elephly.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36817) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fNkS8-0001Cp-Tb for guix-devel@gnu.org; Tue, 29 May 2018 15:38:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fNkS8-0006eK-9F for guix-devel@gnu.org; Tue, 29 May 2018 15:38:40 -0400 In-Reply-To: <87h8mqqzle.fsf@elephly.net> (Ricardo Wurmus's message of "Tue, 29 May 2018 16:57:17 +0200") 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: Ricardo Wurmus Cc: Guix-devel Hello! Ricardo Wurmus skribis: > It would be great to have both! I=E2=80=99d like the existing reference = manual > to remain as the canonical description of all features of Guix, so that > an additional story-centered document (whether that be a dedicated > section or a separate file) can guide readers to more information if > they might need it. I think it=E2=80=99s not all-or-nothing though. Our manual could be better structured and it could include more examples. I like the =E2=80=9Ctraditional=E2=80=9D GNU manuals (libc, Emacs, Gnus, et= c.), which work very well for me, even though they=E2=80=99re only =E2=80=9Clocally user-story-based=E2=80=9D, so to speak. Ludo=E2=80=99.