GNU bug report logs - #42317
Adding a "Running Guix on a Linode" to the cookbook

Previous Next

Full log

View this message in rfc822 format

From: Ludovic Courtès <ludo <at> gnu.org>
To: Joshua Branson <jbranso <at> dismail.de>
Cc: 42317 <at> debbugs.gnu.org
Subject: [bug#42317] [PATCH] doc: cookbook: Adding a section "Running Guix on a Linode Server
Date: Mon, 07 Sep 2020 15:59:11 +0200

Hi Joshua,

Thanks for following up on this!  Minor comments:

Joshua Branson <jbranso <at> dismail.de> skribis:

> +@node Running Guix on a Linode Server
> +@section Running Guix on a Linode Server
> +@cindex linode
> +
> +Start with a recommended Debian server.  We recommend using the default
  ^
I’d start the sentence with something like “To run Guix on a server
hosted by @uref{https://www.linode.com/, Linode}, start with a …”.
(That makes it clear what we’re talking about, what Linode is, etc.)

> +distro as a way to bootstrap Guix. Create your @code{SSH} keys.

[...]

> +Be sure to add your @code{SSH key} for easy login to the remote server.

[...]

> +Power the @code {Linode} down. In the @code{Linode's}

I realize I wasn’t clear: @code is for code snippets.  When referring to
Linode (the service/company) or SSH (the protocol), just write it as is,
without @code.

You would use @code for a command (like @code{rm -rf /foo}) and @file
for a file name (like @file{/dev/sdc}).  Text enclosed in @code or @file
is rendered with a fixed-width font and possibly a different background
color.

> +"..." and select "Edit", then on that menu add to /dev/sdc the "Guix"
                                                     ^
@file here.

> +root@@<your-server-ip-here>}. (You can find your server ip address in
         ^
@var{your-server-ip-here}

And s/ip/IP/.

Let me know if you can take care of those last (I promise!) changes.

Thank you!

Ludo’.

Previous Next

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