On Wednesday 05 September 2007 03:57:41 Taymour A. El Erian wrote:
Pierangelo Masarati wrote:
Taymour A. El Erian wrote:
The docs of openldap are really not clear
I suggest you make more precise statements: what's not clear, and how should it be improved. Otherwise your statement is simply offensive with respect to the many persons that voluntarily (i.e. without being paid, and often out of their little spare time) dedicated to writing the documentation. In fact, as developers, we shouldn't care too much about documenting our work. All in all, we can read the code, and we already know how it works, so we shouldn't care too much about your needs as soon as they do not match ours. Note that I intentionally ignored your question, since it has been answered many times, as you may find out by searching the archives, and answering it once more seemed to be a real waste of time that I could have dedicated to improving the documents, if I received a valid feedback about where improvement is needed.
p.
Pierangelo,
I don't want to get into a debate about the importance ofdocumentation, but documentation is really one of the most important things about software. If you as a developer understand the code, this doesn't mean the code is usable since most of those who use it are not developers and do not know how to read the code. Everybody appreciates the time and effort given by the developers. The administrator guide has no mention of the overlays (at least not chain) and the man pages do not give enough description, also the administrator guide could add examples for some configurations, maybe like those ones being asked in the mailing list.
Oh please, stop bitching and moaning about the documentation! I can't take it anymore on this list. Why don't you go to work and send in documentation improvements? I'm not a developer but I fully agree with them. If you want better documentation, send your improvements to ITS or to the FAQ. As a good LDAP admin you can figure out how it works.
kk