From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH] Quick-start guide Date: Thu, 16 Jun 2016 12:51:51 +0200 Message-ID: <87d1nhieyg.fsf@gnu.org> References: <8760tjkft8.fsf@gnu.org> <20160611174955.GA9544@jasmine> 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]:48893) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bDUu1-0004W1-DN for guix-devel@gnu.org; Thu, 16 Jun 2016 06:52:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bDUtw-0006Ru-CV for guix-devel@gnu.org; Thu, 16 Jun 2016 06:52:00 -0400 In-Reply-To: (yoosty@gmail.com's message of "Tue, 14 Jun 2016 22:07:58 -0700") 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: yoosty@gmail.com Cc: guix-devel@gnu.org Hi, yoosty@gmail.com skribis: > After reading the feedback here and spending some more time in IRC (which > really drives home the feedback about translations and colloquialisms, > thanks John) I would like to do the following: > - Add a contiguous set of examples to the existing "System Installation" > section (such that if you follow the examples you will almost certainly e= nd > up with a working system, even if you don't read much of anything else) You mean OS config examples? Currently there are 3 example configurations. We could add more, but I wonder if that wouldn=E2=80=99t b= e too much for the manual itself (we could still add more to the installation image, though.) > - Add at least one more sub-section to "System Installation" that > introduces users to extending/customizing the initial system's .scm file > -- Something like a "Where to go from here? Customizing your installation= ." > -- A chance to tease users in to Scheme programming Makes sense. The =E2=80=9CUsing the Configuration System=E2=80=9D section = was intended to achieve this, but maybe it=E2=80=99s failing. Do you think it could be improved, or is a new section needed, and if so, how should we articulate both? Thanks, Ludo=E2=80=99.