Re: Some things to be aware of for docs

2016-02-27 Thread Andreas Enge
On Sat, Feb 27, 2016 at 06:27:32PM +0100, Ludovic Courtès wrote: > Andreas Enge skribis: > > One of the doc patches I just pushed has added this reminder. > Really? I was referring to this bit from 2014: Indeed I am mistaken; I also only find the snippet you quote. Sorry for

Re: Some things to be aware of for docs

2016-02-24 Thread Ludovic Courtès
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,

Re: Some things to be aware of for docs

2016-02-15 Thread Esteban Enrique
Yes, and unfortunately it is far from concrete and simple at this point. It basically says 'the drive should be partitioned.' I think adding a quick step like you say should be sufficient without going into too much detail. It just a suggestion, or an example config. On Mon, Feb 15, 2016 at 5:28

Re: Some things to be aware of for docs

2016-02-15 Thread myglc2
Leo Famulari writes: > On Mon, Feb 15, 2016 at 02:33:47PM -0500, Esteban Enrique wrote: [...] >> 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

Re: Some things to be aware of for docs

2016-02-15 Thread Nils Gillmann
Esteban Enrique writes: > On 02/15/2016 05:00 PM, Leo Famulari wrote: >> Personally, I feel a tension between improving the fdisk manual so that >> beginners can use it and just giving step-by-step instructions in our >> manual. >> >> I really don't like Arch's

Re: Some things to be aware of for docs

2016-02-15 Thread Nils Gillmann
Leo Famulari writes: > On Mon, Feb 15, 2016 at 02:33:47PM -0500, Esteban Enrique wrote: >> >> 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

Re: Some things to be aware of for docs

2016-02-15 Thread Esteban Enrique
On 02/15/2016 05:00 PM, Leo Famulari wrote: Personally, I feel a tension between improving the fdisk manual so that beginners can use it and just giving step-by-step instructions in our manual. I really don't like Arch's approach of working around poor upstream manuals by giving step-by-step

Re: Some things to be aware of for docs

2016-02-15 Thread Leo Famulari
On Mon, Feb 15, 2016 at 02:33:47PM -0500, Esteban Enrique wrote: > 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). Thanks for

Some things to be aware of for docs

2016-02-15 Thread Esteban Enrique
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