mbox series

[bug#43141,0/1] "Getting Started" section for the manual

Message ID 20200831204753.20291-1-ludo@gnu.org
Headers show
Series "Getting Started" section for the manual | expand

Message

Ludovic Courtès Aug. 31, 2020, 8:47 p.m. UTC 
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(-)

Comments

Simon Tournier Sept. 9, 2020, 11:53 a.m. UTC | #1 
Hi Ludo,

I am a bit late to the party. :-)

On Mon, 31 Aug 2020 at 22:49, Ludovic Courtès <ludo@gnu.org> wrote:

> What do you think, comrades?

Really nice!


On a side note, let notice that the query "guix search text editor"
seems a good example showing some issue with the current 'relevance'
scoring.

--8<---------------cut here---------------start------------->8---
guix search text editor | recsel -C -P name | head -10
ktexteditor
editorconfig-core-c
editorconfig-vim
java-eclipse-text
vim
vim-full
python-editorconfig
emacs-editorconfig
qemacs
ne
--8<---------------cut here---------------end--------------->8---

And for example, the package Emacs is ranked 19th which is not so-much
satisfactory.

--8<---------------cut here---------------start------------->8---
guix search text editor | recsel -C -P name | grep -n emacs
8:emacs-editorconfig
9:qemacs
18:guile-emacs
19:emacs
20:emacs-xwidgets
21:emacs-wide-int
22:emacs-no-x
23:emacs-no-x-toolkit
24:emacs-next
25:emacs-minimal
59:emacs-objed
63:emacs-nhexl-mode
--8<---------------cut here---------------end--------------->8---

Well, another story. :-)


Cheers,
simon