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: Sun, 03 Jun 2018 22:40:57 +0200 Message-ID: <8736y361t2.fsf@gnu.org> References: <87h8mu1lv9.fsf@gnu.org> <87muwk2fok.fsf@gmail.com> <87h8mshvdz.fsf@elephly.net> <87lgc2r31y.fsf@elephly.net> <87h8mqqzle.fsf@elephly.net> <87muwiuu9u.fsf@gnu.org> <877enmqgaw.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]:46825) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPZoC-0007Pc-EH for guix-devel@gnu.org; Sun, 03 Jun 2018 16:41:01 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fPZoB-0002aC-J1 for guix-devel@gnu.org; Sun, 03 Jun 2018 16:41:00 -0400 In-Reply-To: <877enmqgaw.fsf@elephly.net> (Ricardo Wurmus's message of "Tue, 29 May 2018 23:53:59 +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: > Yes, this can work. It=E2=80=99s hard for me to imagine where one would = put > prose that resembles a tutorial in our current manual. It currently > leans very heavily towards a reference manual, which discourages me from > adding elaborate examples. > > There=E2=80=99s also the danger of interrupting the flow with too many big > inline examples. Currently, it is easy to understand the big picture > because the prose isn=E2=80=99t separated by step for step instructions. Yeah, I agree. > It would be sad to miss out on good tutorials just because they don=E2=80= =99t > fit into the current manual; and it would be just as sad to clutter the > manual by filling it with tutorials that would seem out of place. Sure. So I think those tutorials that don=E2=80=99t fit in the manual shou= ld really have their own life, and that=E2=80=99d be great! Ludo=E2=80=99.