From: "Ludovic Courtès" <ludo@gnu.org>
To: 43141@debbugs.gnu.org
Cc: "Ludovic Courtès" <ludo@gnu.org>
Subject: [bug#43141] [PATCH 0/1] "Getting Started" section for the manual
Date: Mon, 31 Aug 2020 22:47:53 +0200 [thread overview]
Message-ID: <20200831204753.20291-1-ludo@gnu.org> (raw)
Hi Guix!
Earlier today, a colleague of mine said they were giving Guix
“a second chance” after an unsatisfying first attempt. They had
successfully installed it, asked me about “that locale message
from ‘guile’” and what’s going on with PATH and all, and told me
they’d looked for “getting started” kind of material and didn’t
find any.
Indeed, a search for “guix getting started” in popular search engines
yields nothing really useful. (I know we have getting-started videos
on the front page, but for some reason they must not be that easy to
find?)
Anyway, it bothered me that the first-time user experience could
be this bad, so I wrote this section for the manual. It’s designed
to take at most 5mn to read and to have prominent boxes with commands
to paste in a terminal. Perhaps it’s still even too long.
What do you think, comrades?
Ludo’.
Ludovic Courtès (1):
doc: Add "Getting Started" section.
doc/guix.texi | 214 +++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 213 insertions(+), 1 deletion(-)
--
2.28.0
next reply other threads:[~2020-08-31 20:49 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-08-31 20:47 Ludovic Courtès [this message]
2020-08-31 20:57 ` [bug#43141] [PATCH 1/1] doc: Add "Getting Started" section Ludovic Courtès
2020-09-01 18:24 ` Mathieu Othacehe
2020-09-03 21:29 ` bug#43141: " Ludovic Courtès
2020-09-04 1:15 ` [bug#43141] " Leo Famulari
2020-09-09 11:53 ` [bug#43141] [PATCH 0/1] "Getting Started" section for the manual zimoun
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=20200831204753.20291-1-ludo@gnu.org \
--to=ludo@gnu.org \
--cc=43141@debbugs.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).