unofficial mirror of bug-guix@gnu.org 
 help / color / mirror / Atom feed
* bug#47630: Improve guix manual installation docs
@ 2021-04-07  4:55 bo0od
  2021-06-08 17:48 ` Eric Brown
  0 siblings, 1 reply; 2+ messages in thread
From: bo0od @ 2021-04-07  4:55 UTC (permalink / raw)
  To: 47630

Hi There,

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.))

ThX!




^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#47630: Improve guix manual installation docs
  2021-04-07  4:55 bug#47630: Improve guix manual installation docs bo0od
@ 2021-06-08 17:48 ` Eric Brown
  0 siblings, 0 replies; 2+ messages in thread
From: Eric Brown @ 2021-06-08 17:48 UTC (permalink / raw)
  To: bo0od; +Cc: 47630

bo0od <bo0od@riseup.net> writes:

> Hi There,
>
> 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.))
>
> ThX!

If you would have rolled your suggestions into a patch, then your
support team would not have to keep re-implementing it.





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2021-06-08 17:49 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-07  4:55 bug#47630: Improve guix manual installation docs bo0od
2021-06-08 17:48 ` Eric Brown

unofficial mirror of bug-guix@gnu.org 

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://yhetil.org/guix-bugs/0 guix-bugs/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 guix-bugs guix-bugs/ https://yhetil.org/guix-bugs \
		bug-guix@gnu.org
	public-inbox-index guix-bugs

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.yhetil.org/yhetil.gnu.guix.bugs
	nntp://news.gmane.io/gmane.comp.gnu.guix.bugs


AGPL code for this site: git clone http://ou63pmih66umazou.onion/public-inbox.git