[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: Documentation

<quote who="Quanah Gibson-Mount">
> --On Tuesday, March 13, 2007 11:30 PM -0400 Greg Martin
> <gmartin@gmartin.org> wrote:
>> On the other hand, having a howTo get you started on the road to
>> investigation can be a good thing.  For me, the path to LDAP knowledge
>> was not best started with a walk through slapd.conf.  A running server
>> with basic config can allow you to investigate LDAP at an appropriate
>> level.  You may be "lost" when you get to your first tough question, but
>> you are lost in the middle of a highway with a bunch of signs telling
>> you
>> where to head for answers.  No HowTo is created in a vacuum.  More
>> knowledge can be found at the end of the google path when you are ready.
>> Also, when you are trying to learn to fish, you are probably not ready
>> to
>> understand the workings of the reel, how to make lead weights and to tie
>> a perfect knot.
>> My point is that there is more than one way to learn.  Options are good.
> But the majority of "How-To" documents I've found via google are just
> flat-out *wrong*.  The only thing they teach people is incorrect ways to
> set things up, which leads to mass confusion, and complaints to the list
> about "poor documentation".  And getting people to take down and/or fix
> their erroneous how-to's is nearly impossible.

I agree, but sometimes people don't care and get a thought in their head,
"I want to setup OpenLDAP!", follow a howto and they've done it. Now
they're OpenLDAP experts ;-)

As long as we work our docs to be the best they can be (I'm sure that's
been in a movie before ;-) ), then what else can we do?


> --Quanah
> --
> Quanah Gibson-Mount
> Principal Software Developer
> ITS/Shared Application Services
> Stanford University
> GnuPG Public Key: http://www.stanford.edu/~quanah/pgp.html