For what its worth, while I have not worked with OpenLDAP at all, I vigorously support Howard's argument for concise, precise & clear documentation. The state of technical documentation today is pathetic - designed more for people to navigate GUI's than to impart information about how things work. Its reminiscent of cotton candy - a lot more air than content. Another artifact of the Microsoft age....
Arshad Noor StrongAuth, Inc. Howard Chu wrote:
Yes, the OpenLDAP documentation is sparse, and this is a fatal flaw. Yes, what documentation exists is terse, and this is a vital strength. Nobody likes to spend time wading thru docs, and there's nothing gained from saying in 5 sentences what can be stated in only one. Certainly we need to work on expanding the scope of the documentation to cover the numerous holes. But good documentation is concise and to the point, and the docs I've written are precise. There may be a problem with imprecise readers, who skim and skip over things when every single word is crucial, but that's not our fault.
-- Fedora-directory-users mailing list [email protected] https://www.redhat.com/mailman/listinfo/fedora-directory-users
