From mboxrd@z Thu Jan 1 00:00:00 1970 From: Esteban Enrique Subject: Some things to be aware of for docs Date: Mon, 15 Feb 2016 14:33:47 -0500 Message-ID: <56C2281B.90104@gmail.com> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="------------090206090002030902000507" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36240) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aVOu5-0000P0-Tc for help-guix@gnu.org; Mon, 15 Feb 2016 14:33:50 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aVOu4-0005wk-Q7 for help-guix@gnu.org; Mon, 15 Feb 2016 14:33:49 -0500 Received: from mail-qg0-x233.google.com ([2607:f8b0:400d:c04::233]:33690) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aVOu4-0005wg-Kc for help-guix@gnu.org; Mon, 15 Feb 2016 14:33:48 -0500 Received: by mail-qg0-x233.google.com with SMTP id b35so117424868qge.0 for ; Mon, 15 Feb 2016 11:33:48 -0800 (PST) Received: from ?IPv6:2601:182:c401:11b7:bddd:9d60:eef1:62f? ([2601:182:c401:11b7:bddd:9d60:eef1:62f]) by smtp.gmail.com with ESMTPSA id t187sm11558730qht.39.2016.02.15.11.33.47 for (version=TLSv1/SSLv3 cipher=OTHER); Mon, 15 Feb 2016 11:33:47 -0800 (PST) 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: help-guix@gnu.org This is a multi-part message in MIME format. --------------090206090002030902000507 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit 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. 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. Finally, there could be a quick note which explains the slow download and installation from hydra. Overall, the documentation needs work, and I have yet to successfully install GuixSD. I will be trying again soon and reporting problems /from an experienced beginner's perspective/. This will hopefully make the project more beginner friendly. (Note I do not use the term user-friendly (I hate the term), because it does not need to be user-friendly, just welcoming to those that are willing to take the time to learn what is up). 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? --------------090206090002030902000507 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: 8bit 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.

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.

Finally, there could be a quick note which explains the slow download and installation from hydra.

Overall, the documentation needs work, and I have yet to successfully install GuixSD. I will be trying again soon and reporting problems from an experienced beginner's perspective. This will hopefully make the project more beginner friendly. (Note I do not use the term user-friendly (I hate the term), because it does not need to be user-friendly, just welcoming to those that are willing to take the time to learn what is up).

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?

--------------090206090002030902000507--