GNU bug report logs - #69302
[PATCH 0/2] New "Getting Started" section for Guix System

Previous Next

Full log

View this message in rfc822 format

From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: 69302 <at> debbugs.gnu.org
Subject: [bug#69302] [PATCH 1/2] doc: Add “Getting Started with the System” section.
Date: Thu, 22 Feb 2024 20:09:07 +0100

To: Ludovic Courtès <ludo <at> gnu.org>
Cc: 69302 <at> debbugs.gnu.org
Subject: Re: [bug#69302] [PATCH 1/2] doc: Add “Getting Started with the System” section.
From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
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 <ludo <at> gnu.org> 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

Previous Next

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