Quoting Howard Chu hyc@symas.com:
You're welcome to submit a patch for the docs.
I may very well do that... once I develop a better understanding of it all.
As lead developer on the Project I focus on working on the things that would be difficult for anyone else to do. For stuff like this where the information is already available, it's up to the rest of the community to fill in.
Okay, you take care of the progress and we'll take care of the poetry. That sounds like a good arrangement. On the other hand, I would hope that you occasionally review and edit these community contributions. It would be unfortunate if some part of the documentation would, for instance, reflect only my feeble understanding of it.
% ldapsearch -x -H ldap://:9011 -D cn=config -W -b cn=schema,cn=config -s base | grep -A 2 OLcfgOv..:1
BTW, how did you know to look for "OLcfgOv..:1"?
People who understand LDAP don't need to be reminded of things like this. They already understand that LDAP-based configuration means that everything is already part of the LDAP schema, and LDAP schema is self-describing so no external document is absolutely required. (Conversely, people who grumble that LDAP-based config is too complicated and a bad idea simply don't understand LDAP...)
In that case, it's safe to say that my desire for better documentation has everything to do with my current level of understanding. I'd love to say that I could figure it all out just by searching through the LDAP schema, but I'm just not there yet.
Cheers,
Jaap