1 |
On Fri, Apr 19, 2002 at 10:57:58AM -0700, Gaarde wrote: |
2 |
> > DISCLAIMER: I'm intentionally being rude... it helps convey my message. |
3 |
|
4 |
Ah, how kind. |
5 |
|
6 |
> Being so young, the documentation, the sence of community, the code (albeit |
7 |
> in this case a 1.0 is quite nice. Kudos guys!), everything about the |
8 |
Gentoo |
9 |
> product is NOT AS MATURE AS MORE WIDELY DISTRIBUTED DISTRIBUTIONS! What |
10 |
does |
11 |
> 7.2 mean to you? Or 8.1? What does 1.1 mean to you? |
12 |
|
13 |
Well, with people being intentionally rude, it seems like a nicely |
14 |
developed and mature sense of community... |
15 |
|
16 |
> I guess some people just jumped head first into Gentoo without knowing what |
17 |
> they were getting into. (The middle of a development cycle... that just |
18 |
> never ends.) |
19 |
|
20 |
Well, some people wait for a non < 1.0 release. I know I did. |
21 |
|
22 |
> Now, Consider the previous statement a direct *POKE* at the people I refer |
23 |
to |
24 |
> as lusers. Did they read the documentation? |
25 |
|
26 |
What?!?!?! You just stated that the documentation isn't comparably |
27 |
mature. Actually, you stated that it wasn't comparably mature, and |
28 |
that it's quite nice. Or maybe it's just the code that's quite nice. |
29 |
Perhaps you could clarify. Or, being intentionally rude, perhaps you |
30 |
won't. |
31 |
|
32 |
> Did the read the part about profiles? |
33 |
|
34 |
In the comparably less mature documentation? Are you talking about |
35 |
the Portage Manual section 1, under Defaults, which talks about profiles |
36 |
only in the context of default and auto USE variables (and not to change |
37 |
make.defaults under make.profile/)? |
38 |
|
39 |
Perhaps there's another profile documentation section which describes |
40 |
how profiles should be used by the user to submit bug reports for |
41 |
the current profile? Not the Portage User Guid. The word profile |
42 |
doesn't exist there. |
43 |
|
44 |
I think these kind of rants would be more effective with pointers |
45 |
to the exact sections of documentation being referenced. Because |
46 |
as I enter my 7th day of reading gentoo docs, I'm not seeing them. |
47 |
|
48 |
-- |
49 |
John White |
50 |
|
51 |
Mr. White, |
52 |
|
53 |
My point to lusers was simple. Gentoo is young. Thus, the documentation is |
54 |
not as mature as %95 of the newer gentoo users are used to (as compared to |
55 |
more mature distributions). |
56 |
|
57 |
My point to developers was also simple. Preaching patience does not help |
58 |
users effectively use Gentoo. Documention that does not confuse lusers, |
59 |
rather educates them, is absolutely necessary at this juncture. This will |
60 |
get a lot of the lusers off the developers backs so they can do what they do |
61 |
best... write code... not documentation. |
62 |
|
63 |
I believe I made mention about the maturity of the profiles documentation, |
64 |
but whereas that was not the point of my rant, maybe I did not stress it |
65 |
enough. If I did not, then I apologise for the confusion I caused you. |
66 |
|
67 |
Here's an idea! Help the developers help you! Learn as much as you can with |
68 |
what they give you... ask educated questions, get answers, and take notes. |
69 |
Give your notes to the developers so they know where the weeknesses in Gentoo |
70 |
and the documentation there of, resides. |
71 |
|
72 |
Will that help? Let the flames continue. |
73 |
|
74 |
===== |
75 |
--- |
76 |
"To thine own self be true." - Shakespeare |
77 |
|
78 |
__________________________________________________ |
79 |
Do You Yahoo!? |
80 |
Yahoo! Games - play chess, backgammon, pool and more |
81 |
http://games.yahoo.com/ |