From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: Some things to be aware of for docs Date: Wed, 24 Feb 2016 22:26:04 +0100 Message-ID: <8737sher6b.fsf@gnu.org> References: <56C2281B.90104@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:58092) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aYgwm-0006Kq-3X for help-guix@gnu.org; Wed, 24 Feb 2016 16:26:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aYgwh-0002F2-4I for help-guix@gnu.org; Wed, 24 Feb 2016 16:26:12 -0500 In-Reply-To: <56C2281B.90104@gmail.com> (Esteban Enrique's message of "Mon, 15 Feb 2016 14:33:47 -0500") List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org To: Esteban Enrique Cc: help-guix@gnu.org Esteban Enrique skribis: > I am a relative newcomer to GNU/Linux (4 years around) and I have been > wanting to use GuixSD for the past weeks but I have been having > trouble. I think this is due to unclear documents for beginners (like > myself). > > First, formatting the drive. I have some experience with Arch Linux, > so I had a general sense of how to use fdisk. However, for the vast > majority of those who don't know about this, there could be a link or > a self-contained explanation that goes through the process of > formatting the disk. There have been improvements in this regard recently: . But I definitely sympathize with Leo=E2=80=99s comment: I=E2=80=99d rather = include links to actual fdisk documentation than duplicate it. A lot of the OS builds on GNU packages, which is often nicely documented and cross-referenceable (for instance, Parted.) But documentation of non-GNU software is less convenient to cross-reference (for instance, the fdisk implementation of util-linux.) > Next, (I think this has been in the works, but I am not sure) there > needs to be a reminder to run the command 'guix pull' before > installation to avoid any problems. There=E2=80=99s a reminder, but it=E2=80=99s easily overlooked. ;-) Anywa= y, it=E2=80=99s a bug that should be fixed so the reminder isn=E2=80=99t even necessary. > Finally, there could be a quick note which explains the slow download > and installation from hydra. It=E2=80=99s tricky, because we don=E2=80=99t want to =E2=80=9Cwrite in the= stone=E2=80=9D that we have a slow server. ;-) Hopefully this will be addressed soon by switching to a newer machine and/or mirroring things. > There are more things that need help, but those are the ones I saw > lacking most. How often are the docs updated by the way? Docs are updated when new features are added or when people notice things that need to be improved. Thanks for the valuable feedback! Ludo=E2=80=99.