From mboxrd@z Thu Jan 1 00:00:00 1970 From: yoosty@gmail.com Subject: Re: [PATCH] Quick-start guide Date: Thu, 23 Jun 2016 21:55:01 -0700 Message-ID: References: <8760tjkft8.fsf@gnu.org> <20160611174955.GA9544@jasmine> <87d1nhieyg.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a114f804a2999300535fef9bc Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42582) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bGJ91-0000nb-E3 for guix-devel@gnu.org; Fri, 24 Jun 2016 00:55:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bGJ90-0000TQ-2H for guix-devel@gnu.org; Fri, 24 Jun 2016 00:55:07 -0400 In-Reply-To: <87d1nhieyg.fsf@gnu.org> 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: =?UTF-8?Q?Ludovic_Court=C3=A8s?= Cc: guix-devel@gnu.org --001a114f804a2999300535fef9bc Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Thu, Jun 16, 2016 at 3:51 AM, Ludovic Court=C3=A8s wrote: > Hi, > > yoosty@gmail.com skribis: > > > After reading the feedback here and spending some more time in IRC (whi= ch > > 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 > end > > 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= be 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 fil= e > > -- 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 sectio= n was intended > to achieve this, but maybe it=E2=80=99s failing. Do you think it could b= e > improved, or is a new section needed, and if so, how should we > articulate both? > I might be viewing this from the wrong angle.. Maybe what's needed is not necessarily different instructions, but more pointers to the existing instructions :) Can we put some comments in the current example configs to point to existin= g documentation? e.g.: diff --git a/gnu/system/examples/bare-bones.tmpl b/gnu/system/examples/bare-bones.tmpl index 87e8d1e..811a6c3 100644 --- a/gnu/system/examples/bare-bones.tmpl +++ b/gnu/system/examples/bare-bones.tmpl @@ -38,6 +38,8 @@ %base-user-accounts)) ;; Globally-installed packages. + ;; See the "System Configuration"/"Globally-Visible Packages" + ;; section in the Guix manual for more info (packages (cons tcpdump %base-packages)) ;; Add services to the baseline: a DHCP client and Something else I'm probably just missing.. Is there a way to enumerate %base-packages from the command line? I've seen you (Ludo) do this a few times in the videos but I don't recall a mention of instructions for configuring this setup. -- .:Justin:. --001a114f804a2999300535fef9bc Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable


On Thu, Jun 16, 2016 at 3:51 AM, Ludovic Court=C3=A8s <ludo@gnu.org>= wrote:
Hi,

yoosty@gmail.com skribis:

> After reading the feedback here and spending some more time in IRC (wh= ich
> 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 Instal= lation"
> section (such that if you follow the examples you will almost certainl= y end
> up with a working system, even if you don't read much of anything = else)

You mean OS config examples?=C2=A0 Currently there are 3 example
configurations.=C2=A0 We could add more, but I wonder if that wouldn=E2=80= =99t be 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 .sc= m file
> -- Something like a "Where to go from here? Customizing your inst= allation."
> -- A chance to tease users in to Scheme programming

Makes sense.=C2=A0 The =E2=80=9CUsing the Configuration System=E2=80= =9D section was intended
to achieve this, but maybe it=E2=80=99s failing.=C2=A0 Do you think it coul= d be
improved, or is a new section needed, and if so, how should we
articulate both?

I might be viewing this from the wrong angle.. Maybe what's needed is = not
necessarily different instructions,= but more pointers to the existing instructions :)

Can we put some comments in the current example configs to= point to existing
documentation?
e.g.:

diff --git a/gnu/system/exa= mples/bare-bones.tmpl b/gnu/system/examples/bare-bones.tmpl
index 87e8d1= e..811a6c3 100644
--- a/gnu/system/examples/bare-bones.tmpl
+++ b/gnu= /system/examples/bare-bones.tmpl
@@ -38,6 +38,8 @@
=C2=A0=C2=A0=C2=A0= =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 %b= ase-user-accounts))
=C2=A0
=C2=A0=C2=A0 ;; Globally-installed package= s.
+=C2=A0 ;; See the "System Configuration"/"Globally-Vi= sible Packages"
+=C2=A0 ;; section in the Guix manual for more info=
=C2=A0=C2=A0 (packages (cons tcpdump %base-packages))
=C2=A0
=C2= =A0=C2=A0 ;; Add services to the baseline: a DHCP client and



Something else I'm probably just missing.. Is there a way to enum= erate
%base-packages from the command line? I've seen you (Ludo) do = this a few
times in the videos but I don't recall a mention of instr= uctions for configuring
this setup.
=

=C2=A0--
<= br>=C2=A0=C2=A0 .:Justin:.
--001a114f804a2999300535fef9bc--