all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: zimoun <zimon.toutoune@gmail.com>
To: bo0od <bo0od@riseup.net>
Cc: 47630@debbugs.gnu.org
Subject: bug#47630: Improve guix manual installation docs
Date: Tue, 14 Sep 2021 17:41:36 +0200	[thread overview]
Message-ID: <CAJ3okZ1qfYeGu+XkkfcSyuOL6M0zy7DT9ZvoPD3cPOn3mOXDrQ@mail.gmail.com> (raw)
In-Reply-To: <a45e9a7e-6079-8692-0cc3-6f4cc8f2e521@riseup.net>

Hi,

On Tue, 14 Sept 2021 at 16:51, bo0od <bo0od@riseup.net> wrote:

> Fix the documentation as steps works for the end user as if he follow it
> 1 by 1 copy/paste (similar to nix docs as example), Otherwise current
> steps in the docs just junk to the end user. (you dont expect users to
> know and finish steps themselves)

I proposed you to write down these steps as a starting point for
improving the manual to turn it into a patch (for the Manual or the
Cookbook); this is actionable.  Otherwise say « improve this part of
the manual » is not constructive; this is not actionable.  I (and
probably others) do not see what could be improved in this area so it
appears to me hard to improve something that I do not know what. :-)

Last, the manual says:

        This option requires familiarity with GNU/Linux, with the shell,
        and with common administration tools. If you think this is not
        for you, consider using the guided graphical installer.

<https://guix.gnu.org/manual/en/html_node/Manual-Installation.html>

Therefore, it appears to me expected that this section provides only
command hints and not one by one step to complete all the process.
Other said, I expect that user who does not know how to fully complete
will run the Graphical Installer.  Does Nix have a Graphical
Installer?


All the best,
simon




  reply	other threads:[~2021-09-14 16:04 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-07  4:55 bug#47630: Improve guix manual installation docs bo0od
2021-06-08 17:48 ` Eric Brown
2021-07-02 16:47 ` zimoun
2021-07-15 12:56   ` bo0od
2021-08-17 21:28     ` zimoun
2021-09-14 10:35       ` zimoun
2021-09-14 14:50         ` bo0od
2021-09-14 15:41           ` zimoun [this message]
2021-09-26  8:17             ` bo0od
2022-01-04 22:53               ` zimoun
2022-06-23  9:52                 ` zimoun
2022-06-24 10:25                   ` bo0od

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

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

  git send-email \
    --in-reply-to=CAJ3okZ1qfYeGu+XkkfcSyuOL6M0zy7DT9ZvoPD3cPOn3mOXDrQ@mail.gmail.com \
    --to=zimon.toutoune@gmail.com \
    --cc=47630@debbugs.gnu.org \
    --cc=bo0od@riseup.net \
    /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 external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.