| 1 |
Josh Saddler wrote: |
| 2 |
|
| 3 |
> Changing it will not help the most central problem |
| 4 |
> we're up against: that users simply *do not read* documents, period. |
| 5 |
> It's not in their nature. No amount of restructuring or other |
| 6 |
> handholding will change that for them; they have to take the plunge into |
| 7 |
> the technical world of Gentoo on their own. |
| 8 |
|
| 9 |
In the college freshman course I taught with the Handbook over the past few |
| 10 |
years, everyone read the Handbook ( I know because I was in the computer lab |
| 11 |
looking over their shoulders while they were reading it ) but only around 2 in |
| 12 |
each class of 25 were able to successfully install Gentoo without significant |
| 13 |
assistance. |
| 14 |
|
| 15 |
My observation of students that attempt to install Gentoo on their own ( |
| 16 |
outside of this class and without assistance ) is that very few of them are |
| 17 |
successful. |
| 18 |
|
| 19 |
I agree that most people do not read the documentation and this is why they |
| 20 |
fail. My experience indicates, however, that a significant percentage of |
| 21 |
people are reading the Handbook but are still failing because the materials in |
| 22 |
the Handbook are not meeting their needs. |
| 23 |
|
| 24 |
Ted |
| 25 |
-- |
| 26 |
gentoo-doc@g.o mailing list |
Archives