unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: yoosty@gmail.com
To: "Ludovic Courtès" <ludo@gnu.org>
Cc: guix-devel@gnu.org
Subject: Re: [PATCH] Quick-start guide
Date: Thu, 23 Jun 2016 21:55:01 -0700	[thread overview]
Message-ID: <CAGSLf826Urbr5hJPDi_i5tnCaGUEPV-GM9NnDuWMfXxcK0kfdw@mail.gmail.com> (raw)
In-Reply-To: <87d1nhieyg.fsf@gnu.org>

[-- Attachment #1: Type: text/plain, Size: 2401 bytes --]

On Thu, Jun 16, 2016 at 3:51 AM, Ludovic Courtès <ludo@gnu.org> wrote:

> 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
> 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’t 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 file
> > -- Something like a "Where to go from here? Customizing your
> installation."
> > -- A chance to tease users in to Scheme programming
>
> Makes sense.  The “Using the Configuration System” section was intended
> to achieve this, but maybe it’s failing.  Do you think it could 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/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:.

[-- Attachment #2: Type: text/html, Size: 3555 bytes --]

  reply	other threads:[~2016-06-24  4:55 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-06-04 20:00 [PATCH] Quick-start guide yoosty
2016-06-08 12:47 ` Ludovic Courtès
2016-06-11 13:43   ` yoosty
2016-06-11 17:49     ` Leo Famulari
2016-06-12 15:14       ` myglc2
2016-06-12 20:46         ` Ludovic Courtès
2016-06-15  5:07       ` yoosty
2016-06-16 10:51         ` Ludovic Courtès
2016-06-24  4:55           ` yoosty [this message]
2016-06-24 12:36             ` Ludovic Courtès
2016-06-13  0:40 ` John Darrington

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://guix.gnu.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CAGSLf826Urbr5hJPDi_i5tnCaGUEPV-GM9NnDuWMfXxcK0kfdw@mail.gmail.com \
    --to=yoosty@gmail.com \
    --cc=guix-devel@gnu.org \
    --cc=ludo@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).