| 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/ |
Archives