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. >
