| 1 |
Dale wrote: |
| 2 |
> Joshua D Doll wrote: |
| 3 |
> |
| 4 |
>> Mark Knecht wrote: |
| 5 |
>> |
| 6 |
>>> On Thu, Feb 5, 2009 at 12:32 PM, Paul Hartman |
| 7 |
>>> <paul.hartman+gentoo@×××××.com> wrote: |
| 8 |
>>> I completely agree. I like the control also. |
| 9 |
>>> |
| 10 |
>>> I only took a *very* small exception to Joshua's statement that a 'new |
| 11 |
>>> user' could read, follow it and understand what it's telling him/her |
| 12 |
>>> to do and then do it and come out with a working machine. I think it's |
| 13 |
>>> true if the new user builds exactly the 3 partition example shown in |
| 14 |
>>> the docs and does *only* the very basic install on a machine that |
| 15 |
>>> doesn't have Windows, etc. However I think that the docs (not the |
| 16 |
>>> software!) could be improved to handle things like dual-boot, either |
| 17 |
>>> another distro or windows, etc. which personally I think 'new users' |
| 18 |
>>> come up against. Issues about stuff like where to put the MBR, why and |
| 19 |
>>> why not to do that sort of thing, requires (or is vastly enhanced) if |
| 20 |
>>> that new user has some knowledge about hard drives, booting, etc. |
| 21 |
>>> |
| 22 |
>>> - Mark |
| 23 |
>>> |
| 24 |
>>> |
| 25 |
>>> |
| 26 |
>>> |
| 27 |
>> I 100% agree that the docs can and should cover more. Maybe a |
| 28 |
>> flowchart would be useful? |
| 29 |
>> |
| 30 |
>> --Joshua Doll |
| 31 |
>> |
| 32 |
>> |
| 33 |
>> |
| 34 |
> |
| 35 |
> I wish the man pages had more examples. Give me a real world example |
| 36 |
> and I can wrap my poor brain around what it should look like when I do |
| 37 |
> something. |
| 38 |
> |
| 39 |
> Dale |
| 40 |
> |
| 41 |
> :-) :-) |
| 42 |
> |
| 43 |
> |
| 44 |
> |
| 45 |
Man pages are notoriously bad. The gentoo handbook and other official |
| 46 |
docs are great OTOH. |
| 47 |
|
| 48 |
--Joshua Doll |
Archives