From mboxrd@z Thu Jan 1 00:00:00 1970 From: yoosty@gmail.com Subject: Re: [PATCH] Quick-start guide Date: Sat, 11 Jun 2016 06:43:21 -0700 Message-ID: References: <8760tjkft8.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a1145bcf2b39c00053500d682 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:43334) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBjCC-00008U-Ng for guix-devel@gnu.org; Sat, 11 Jun 2016 09:43:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bBjCA-0002jV-BE for guix-devel@gnu.org; Sat, 11 Jun 2016 09:43:27 -0400 In-Reply-To: <8760tjkft8.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: =?UTF-8?Q?Ludovic_Court=C3=A8s?= Cc: guix-devel@gnu.org --001a1145bcf2b39c00053500d682 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Yes, I would say it is a bit redundant, partially on purpose :) I wanted to create a short set of instructions to help users get in to a GuixSD installation quickly, with the intent that they can poke around inside the system and then read through the "System Installation" section for more in-depth information. Why? I was looking for one myself and couldn't find it ;) I've seen one or two users in IRC who might benefit as well. Upon further reflection.. The Guix manual might not be an appropriate place for such a guide. If the Guix manual isn't a good place for such a set of instructions, do you have any suggestions for a location (blog, etc)? On Wed, Jun 8, 2016 at 5:47 AM, Ludovic Court=C3=A8s wrote: > Hello! > > yoosty@gmail.com skribis: > > > +@node Quick Setup > > +@section Quick Setup > > + > > +So you just want the quick-and-dirty guide? Assuming you have some > > familiarity > > +with GNU/Linux systems in general and have installed one several times > > before > > +you can probably get started with a few notes while citing > > +@pxref{GNU Distribution} as necessary. As this is a quick-setup guide > > we'll use > > +some example defaults. > > + > > +The general idea is that you will: > > +@itemize > > +@item @uref{https://gnu.org/software/guix/download/, Download} the USB > > installer > > +@item Transfer the image to a USB stick (@pxref{USB Stick Installation= }) > > +using dd > > +@item Boot the USB stick > > +@item Configure @pxref{Preparing for Installation,Networking} > > +@item Set your @xref{Preparing for Installation,Disk Partitioning} > > +(using an msdos label instead of a gpt label might be easier at the > moment) > > +@item Mount your partitions (e.g. /mnt) > > +@item Run (again, e.g. /mnt) @command{herd start cow-store /mnt} > > +@item Create a system configuration file using > > +@xref{Proceeding with the Installation} and > > +@xref{Using the Configuration System} as guides. It is suggested to > start > > +with the bare-bones template as you can easily re-configure your syste= m > > +once it is up. > > +@item Using /mnt/root/guix_configs/config00.scm as the example config > file > > +and /mnt as the example install mount point, run > > +@command{guix system init /mnt/root/guix_configs/config00.scm /mnt} > > +@item Cross your fingers and grab a beer > > +@item If you're using reasonably new hardware and a bare-bones config > > +then guix should be done before your beverage and you can run > > +@command{reboot} > > +@end itemize > > [...] > > At first sight this seems redundant with the =E2=80=9CSystem Installation= =E2=80=9D > section, no? > > What shortcoming are you trying to address? > > Thanks for helping out! > > Ludo=E2=80=99. > --=20 .:Justin:. --001a1145bcf2b39c00053500d682 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Yes, I would say it is a bit redundant, par= tially on purpose :)

I wanted to create a short set of instruc= tions to help users get in to a GuixSD installation quickly, with the inten= t that they can poke around inside the system and then read through the &qu= ot;System Installation" section for more in-depth information.

=
Why? I was looking for one myself and couldn't find it ;) I'v= e seen one or two users in IRC who might benefit as well.

Upon further reflection.. The Guix manual might not be an appropriate plac= e for such a guide. If the Guix manual isn't a good place for such a se= t of instructions, do you have any suggestions for a location (blog, etc)?<= br>

On= Wed, Jun 8, 2016 at 5:47 AM, Ludovic Court=C3=A8s <ludo@gnu.org>= wrote:
Hello!

yoosty@gmail.com skribis:

> +@node Quick Setup
> +@section Quick Setup
> +
> +So you just want the quick-and-dirty guide? Assuming you have some > familiarity
> +with GNU/Linux systems in general and have installed one several time= s
> before
> +you can probably get started with a few notes while citing
> +@pxref{GNU Distribution} as necessary. As this is a quick-setup guide=
> we'll use
> +some example defaults.
> +
> +The general idea is that you will:
> +@itemize
> +@item @uref{https://gnu.org/software/guix/download/, Download} the USB
> installer
> +@item Transfer the image to a USB stick (@pxref{USB Stick Installatio= n})
> +using dd
> +@item Boot the USB stick
> +@item Configure @pxref{Preparing for Installation,Networking}
> +@item Set your @xref{Preparing for Installation,Disk Partitioning} > +(using an msdos label instead of a gpt label might be easier at the m= oment)
> +@item Mount your partitions (e.g. /mnt)
> +@item Run (again, e.g. /mnt) @command{herd start cow-store /mnt}
> +@item Create a system configuration file using
> +@xref{Proceeding with the Installation} and
> +@xref{Using the Configuration System} as guides. It is suggested to s= tart
> +with the bare-bones template as you can easily re-configure your syst= em
> +once it is up.
> +@item Using /mnt/root/guix_configs/config00.scm as the example config= file
> +and /mnt as the example install mount point, run
> +@command{guix system init /mnt/root/guix_configs/config00.scm /mnt} > +@item Cross your fingers and grab a beer
> +@item If you're using reasonably new hardware and a bare-bones co= nfig
> +then guix should be done before your beverage and you can run
> +@command{reboot}
> +@end itemize

[...]

At first sight this seems redundant with the =E2=80=9CSystem Installation= =E2=80=9D
section, no?

What shortcoming are you trying to address?

Thanks for helping out!

Ludo=E2=80=99.



--

=C2=A0=C2=A0 .:Justin:.
--001a1145bcf2b39c00053500d682--