Re: improve installation instructions

[Ludovic Courtès]

Hello!

Ricardo Wurmus <address@hidden> skribis:

> I just installed Guix as a package manager on an aarch64 box.  The
> manual makes it a little difficult to perform all these steps, because
> the commands cannot be easily copied.  We do have the shell script, but
> the manual mentions it only in passing – as a user I skipped over the
> introduction and went straight to step 1, right past the script.
>
> What do you think about mentioning the script in the Installation
> section and only asking users to look in the subsections for details?

Good idea.

> +We recommend the use of this
> address@hidden://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh,
> +shell installer script} to install Guix on top of a running GNU/Linux system,
> +thereafter called a @dfn{foreign address@hidden section is concerned
> +with the installation of the package manager, which can be done on top of a
> +running GNU/Linux system.  If, instead, you want to install the complete GNU
> +operating system, @pxref{System Installation}.} The script automates the
> +download, installation, and initial configuration of Guix.  It should be run
> +as the root user.

Perhaps you could wrap this paragraph in address@hidden Note” to make it
even more visible.

Thanks,
Ludo’.