1 |
Joshua D Doll wrote: |
2 |
> Dale wrote: |
3 |
>> Joshua D Doll wrote: |
4 |
>> |
5 |
>>> Mark Knecht wrote: |
6 |
>>> |
7 |
>>>> On Thu, Feb 5, 2009 at 12:32 PM, Paul Hartman |
8 |
>>>> <paul.hartman+gentoo@×××××.com> wrote: I completely agree. I |
9 |
>>>> like the control also. |
10 |
>>>> |
11 |
>>>> I only took a *very* small exception to Joshua's statement that a 'new |
12 |
>>>> user' could read, follow it and understand what it's telling him/her |
13 |
>>>> to do and then do it and come out with a working machine. I think it's |
14 |
>>>> true if the new user builds exactly the 3 partition example shown in |
15 |
>>>> the docs and does *only* the very basic install on a machine that |
16 |
>>>> doesn't have Windows, etc. However I think that the docs (not the |
17 |
>>>> software!) could be improved to handle things like dual-boot, either |
18 |
>>>> another distro or windows, etc. which personally I think 'new users' |
19 |
>>>> come up against. Issues about stuff like where to put the MBR, why and |
20 |
>>>> why not to do that sort of thing, requires (or is vastly enhanced) if |
21 |
>>>> that new user has some knowledge about hard drives, booting, etc. |
22 |
>>>> |
23 |
>>>> - Mark |
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 |
49 |
> |
50 |
Man pages notoriously bad?! Now that's a stance I can hardly understand, |
51 |
they've always been a godsend in my experience! Just practice using a |
52 |
command a few times, look through the options and learn it in the period |
53 |
of ten minutes, and a man page has done its purpose. If this stance is |
54 |
due to your own inadequate ability to read technical documents, then do |
55 |
not apply the lacking to anything but your own capacity for comprehension. |