<quote who="Joseph Dickson">
Reposting for Gavin -- doesn't seem to have gone to the list..
Thanks.
<snip>
I don't have the energy to repeat myself about contributing etc., so please search the archives for my thoughts on bashing our documentation.
In general, I just wanted to remind everyone that OpenLDAP's documentation isn't great, and saying that it is doesn't really help. Compare to the documentation of other projects (for example, Postgres),
http://www.postgresql.org/about/history ;-)
Umm Postgres started in 1986, a good 12 years before OpenLDAP was created, but not really an excuse.
I think we can agree that there's quite a bit of room for improvement. I know it would be better for me to step up and begin writing rather than rubbing salt in the wound, as it were, but sadly my free time is already devoted to other things so the best I can do at this point is try to remind people that there is work to be done on the documentation.
Would you be so humble as to spare the time to list improvements or topics that aren't covered, or in fact the "work to be done on the documentation", as it's very hard to guess. That would be ever so kind.
I know it's not finished (Admin Guide), but input (whether content or direction) from the community is always appreciated.
Gavin.
Gavin Henry writes:
Umm Postgres started in 1986, a good 12 years before OpenLDAP was created, but not really an excuse.
Though OpenLDAP derives from Umich LDAP, which according to its copyright notices is from 1990. (The oldest release I can find is umich ldap-2.0 from 1992.)
Come to think of it, http://www.openldap.org/software/roadmap.html seems to be OpenLDAP's version of a history file, so I think it would be proper to start it off with an item a la
University of Michigan (Umich) LDAP 1.0? - 3.3 (1990? - 1996) The first LDAP implementation, now discontinued. OpenLDAP is derived from the last release, ldap-3.3.
or to include that in the roadmap text about OpenLDAP 1.0.
openldap-software@openldap.org