GNU bug report logs - #47630
Improve guix manual installation docs

Previous Next

Full log

View this message in rfc822 format

From: bo0od <bo0od <at> riseup.net>
To: zimoun <zimon.toutoune <at> gmail.com>
Cc: 47630 <at> debbugs.gnu.org
Subject: bug#47630: Improve guix manual installation docs
Date: Sun, 26 Sep 2021 08:17:35 +0000

> I proposed you to write down these steps as a starting point for
> improving the manual to turn it into a patch

Will do that for next guix release hopefully.

zimoun:
> Hi,
> 
> On Tue, 14 Sept 2021 at 16:51, bo0od <bo0od <at> 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
> 

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.