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: Sun, 12 Jun 2016 22:46:10 +0200 Message-ID: <87twgyi19p.fsf@gnu.org> References: <8760tjkft8.fsf@gnu.org> <20160611174955.GA9544@jasmine> <86r3c2a17p.fsf@gmail.com> 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]:38587) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bCCGy-0007VR-Fu for guix-devel@gnu.org; Sun, 12 Jun 2016 16:46:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bCCGs-0001zD-IX for guix-devel@gnu.org; Sun, 12 Jun 2016 16:46:19 -0400 In-Reply-To: <86r3c2a17p.fsf@gmail.com> (myglc2@gmail.com's message of "Sun, 12 Jun 2016 11:14:34 -0400") 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: myglc2 Cc: guix-devel@gnu.org Hi! myglc2 skribis: > This is the correct goal, but the manual as it stands is problematic for > first-time users for reasons such as: it's overwhelmingly copious; > information is "shredded" into different sections; the is confusing > terminology; finding one's way around is difficult; there is virtually > no guidance of what to read first or how to proceed. Woow, that=E2=80=99s a lot of room for progress. :-) I think all of these issues need to be clarified and addressed. The problem for me as a maintainer is that we don=E2=80=99t have a test sui= te for the manual. So I cannot simply apply a big patch and run =E2=80=9Cmake check=E2=80=9D to ensure that nothing =E2=80=9Cbroke=E2=80=9D in the manual= . So I=E2=80=99m both receptive and demanding here ;-), because it=E2=80=99s often the case that editing the manual is more work than adding a couple of paragraphs here and there. > I see this patch as an attempt to address some of these difficulties. Sure, my concern is about the duplication of information and additional maintenance burden that ensues. > I suggest we add a new "Getting Started" section between "Introduction" > and "Installation". "Getting Started" should initially include a > discussion of how to decide whether to install Guix or GuixSD and > quick-start sections for each. That sounds like a good idea. To begin with, would you like to propose a =E2=80=9CGuix Quick Start=E2=80=9D section that we could put between the = =E2=80=9CFeatures=E2=80=9D and =E2=80=9CInvoking =E2=80=98guix package=E2=80=99=E2=80=9D sections? Thanks, Ludo=E2=80=99.