Subject: [bug#69302] [PATCH 1/2] doc: Add “Getting Started with the System” section.

From: "pelzflorian (Florian Pelz)" <[email-masked]>
Date: Thu, 22 Feb 2024 20:09:07 +0100

To: Ludovic Courtès <[email-masked]>
Cc: [email-masked]
Subject: Re: [bug#69302] [PATCH 1/2] doc: Add “Getting Started with the System” section.
From: "pelzflorian (Florian Pelz)" <[email-masked]>
Gcc: nnfolder+archive:sent.2024-02
--text follows this line--
This rewrite makes Guix System more approachable.  Thank you for the tip
with “guix style -f”!

Ludovic Courtès <[email-masked]> writes:
> * doc/guix.texi (Getting Started with the System): New node.
> (After System Installation): Refer to it.  Remove note about ‘sudo guix
> pull’.

I was alarmed that you remove the note about sudo, but indeed you just
moved it and not removed.

> (Getting Started): Refer to it.  Remove note about ‘guix system roll-back’.

As above.

> +@quotation Note
> +You can store your system configuration file anywhere you like---it
> +doesn't have to be at @file{/etc/config.scm}.  It's a good idea to keep
> +it under version control, for instance in a Git repository.
> +@end quotation

Could you add a reference @uref{https://git-scm.com/book/en/, Git} like
we do in the “Invoking guix pull” section?

> +The @emph{entire} configuration of the system---user accounts, system
> +services, timezone, locale settings---is declared this file, which
> +follows this template:

is declared *in* this file

>  @node Using the Configuration System
>  @section Using the Configuration System
>  
> +The previous section showed the overall workflow you would follow when
> +administrating a Guix System machine (@pxref{Getting Started with the

“administering” seems more correct than “administrating”.  I’m not a
native English speaker though.

>  The operating system is configured by providing an
>  @code{operating-system} declaration in a file that can then be passed to
> -the @command{guix system} command (@pxref{Invoking guix system}).  A
> -simple setup, with the default Linux-Libre
> -kernel, initial RAM disk, and a couple of system services added to those
> +the @command{guix system} command, as we've seen before (@pxref{Invoking
> +guix system}).  […]

Could you move the (@pxref{Invoking guix system}) before the “, as we've
seen before”?  Otherwise it appears as if “before” refers to “Invoking
guix system”.

Regards,
Florian