[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#47630: Improve guix manual installation docs

From: bo0od
Subject: bug#47630: Improve guix manual installation docs
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..


On Wed, 07 Apr 2021 at 04:55, bo0od <bo0od@riseup.net> wrote:

Checking here:


This section actually misses alot of commands and its not nice to give only
hint commands and leave step by step explanation e.g:


"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:


(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

Thanks for your report.  Could you propose a concrete wording solving
the issues you see?


reply via email to

[Prev in Thread] Current Thread [Next in Thread]