1 |
Saphirus Sage wrote: |
2 |
> Joshua D Doll wrote: |
3 |
> |
4 |
>> Dale wrote: |
5 |
>> |
6 |
>>> Joshua D Doll wrote: |
7 |
>>> |
8 |
>>> |
9 |
>>>> Mark Knecht wrote: |
10 |
>>>> |
11 |
>>>> |
12 |
>>>>> On Thu, Feb 5, 2009 at 12:32 PM, Paul Hartman |
13 |
>>>>> <paul.hartman+gentoo@×××××.com> wrote: I completely agree. I |
14 |
>>>>> like the control also. |
15 |
>>>>> |
16 |
>>>>> I only took a *very* small exception to Joshua's statement that a 'new |
17 |
>>>>> user' could read, follow it and understand what it's telling him/her |
18 |
>>>>> to do and then do it and come out with a working machine. I think it's |
19 |
>>>>> true if the new user builds exactly the 3 partition example shown in |
20 |
>>>>> the docs and does *only* the very basic install on a machine that |
21 |
>>>>> doesn't have Windows, etc. However I think that the docs (not the |
22 |
>>>>> software!) could be improved to handle things like dual-boot, either |
23 |
>>>>> another distro or windows, etc. which personally I think 'new users' |
24 |
>>>>> come up against. Issues about stuff like where to put the MBR, why and |
25 |
>>>>> why not to do that sort of thing, requires (or is vastly enhanced) if |
26 |
>>>>> that new user has some knowledge about hard drives, booting, etc. |
27 |
>>>>> |
28 |
>>>>> - Mark |
29 |
>>>>> |
30 |
>>>>> |
31 |
>>>>> |
32 |
>>>>> |
33 |
>>>> I 100% agree that the docs can and should cover more. Maybe a |
34 |
>>>> flowchart would be useful? |
35 |
>>>> |
36 |
>>>> --Joshua Doll |
37 |
>>>> |
38 |
>>>> |
39 |
>>>> |
40 |
>>>> |
41 |
>>> I wish the man pages had more examples. Give me a real world example |
42 |
>>> and I can wrap my poor brain around what it should look like when I do |
43 |
>>> something. |
44 |
>>> |
45 |
>>> Dale |
46 |
>>> |
47 |
>>> :-) :-) |
48 |
>>> |
49 |
>>> |
50 |
>>> |
51 |
>>> |
52 |
>> Man pages are notoriously bad. The gentoo handbook and other official |
53 |
>> docs are great OTOH. |
54 |
>> |
55 |
>> --Joshua Doll |
56 |
>> |
57 |
>> |
58 |
> Man pages notoriously bad?! Now that's a stance I can hardly understand, |
59 |
> they've always been a godsend in my experience! Just practice using a |
60 |
> command a few times, look through the options and learn it in the period |
61 |
> of ten minutes, and a man page has done its purpose. If this stance is |
62 |
> due to your own inadequate ability to read technical documents, then do |
63 |
> not apply the lacking to anything but your own capacity for comprehension. |
64 |
> |
65 |
> |
66 |
> |
67 |
Just cause you haven't run across an uninformative/incomplete man page |
68 |
doesn't mean others haven't. Also man pages lacking valuable information |
69 |
is the reason why GNU has switched to the majority of their packages to |
70 |
using info! You shouldn't flame someone because your experiences are |
71 |
different from their's. |
72 |
|
73 |
--Joshua Doll |