Subject: Re: bug#47630: Improve guix manual installation docs

From: bo0od <[email-masked]>
Date: Thu, 15 Jul 2021 12:56:17 +0000

> Could you propose a concrete wording solving
 > the issues you see

Not really because english is not my mother tongue so there going to be 
errors in grammars, choosing of words..etc so better to be written by 
someone who has better english than me.

But for the commands to go on step by step i can give that with little 
text and any webadmin can pick it up and arrange it accordingly.

If guix documentation built on wikimedia it would be much easier because 
i can register and upload my changes and can be reviewed and updated, 
But using email for this is not the best way to achieve it but what to do..

zimoun:
> Hi,
> 
> On Wed, 07 Apr 2021 at 04:55, bo0od <[email-masked]> wrote:
> 
>> Checking here:
>>
>> https://guix.gnu.org/manual/en/html_node/Manual-Installation.html
>>
>> This section actually misses alot of commands and its not nice to give only
>> hint commands and leave step by step explanation e.g:
>>
>> https://guix.gnu.org/manual/en/html_node/Keyboard-Layout-and-Networking-and-Partitioning.html
>>
>> "parted /dev/sda set 1 esp on"
>>
>> This command wont work without labeling the partition "parted /dev/sda --
>> mklabel gpt" and so on..
>>
>> This mean user cant copy and paste he need to figure out the errors while hes
>> follow the documentation because it doesn't give to the user the full picture.
>>
>> I suggest to take a look at NixOS docs which goes step by step without jumping
>> any necessary one:
>>
>> https://nixos.org/manual/nixos/stable/index.html#sec-installation-partitioning
>>
>> (Unclear documentation causes unsolvable or ambiguous questions from users and
>> its troublesome to the support team to re-add the missing parts of the docs in
>> their support.(Assuming they figured out where is the issue user is falling
>> in.))
> 
> Thanks for your report.  Could you propose a concrete wording solving
> the issues you see?
> 
> Thanks,
> simon
>