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 --]
next prev parent 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).