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

Re: LDAP authenticaton against PAM how-to

TechnoSophos wrote:
> But clarity in the documentation is certainly a desired feature, and
> as it stands now, it seems (based on responses to the list, as well as
> my own personal experience) that going from a small LDAP server
> following basically the default configuration to a more complex
> directory environment requires a pretty steep learning curve. Good
> documentation could improve that situation.

Yes, jump on in.

IMHO the OpenLDAP docs are not less detailed than that of other good
software packages.

> *. I don't find the argument that other products have bad
> documentation to be justification for not creating good documentation.

Yes, jump on in.

> I would even go so far as to suggest that much of the growth in
> postfix, exim, and the like is due to the poor documentation in
> sendmail and cyrus.

You think postfix has better docs? It has a simpler configuration syntax
which makes docs almost unnecessary for the experienced admin.

> *. I don't actually think the problem with OpenLDAP is a *lack* of
> documentation (which is certainly a problem with Cyrus). Again, the
> man pages are very thorough and very complete. And if one reads the
> RFCs (which are also exceptionally good) and some of the code, then
> one can get along pretty well with OpenLDAP. But that seems to be a
> high barrier of entry. I'd like to see it get lower.

Yes, everything should be easier at no cost.
Who's going to take that task? You?

> Tim Howes' book is excellent. I would certainly not dispute that. But
> at nearly 1000 pages, it's not exactly a breeze compared to the RFCs.

So reading such a book is too much effort for getting a good OpenLDAP admin?

> [..] is that this
> list is on the tough side. And this generally negative attitude
> impedes improvement because it turns people away.

Some list members are simply tired by people asking for more docs
without really contributing to it. You have to change your own role from
a consumer to a producer when using open source software. Everything
else is a really lame attitude.

> And I am using
> Emmanuel's attempt to contribute to the documentation as a case in
> point.


Ciao, Michael.