Any community has more than one throat to choke.
By mcraig on Sep 03, 2007
One of the biggest benefits with the OpenDS Wiki has been the high volume and high value of community contributions. Wiki technology makes it simple, almost tempting, for folks who know their subject matter to add good content. Perhaps because of the public nature of all edits, the signal to noise ratio stays high, too.
Even so, we want to put the quality bar for official documentation as high as for the code itself. That is why we apply a two-phase documentation review process, similar to a code review and testing process.
Will that ever be good enough? Maybe not.
When your operations depend on the reliability and availability of your directory service, you want one throat to choke, right? Any community has more than one throat to choke.
Our aim today is to continue with wikis as the community source of the latest and greatest documentation. We then expect to bring refined and validated content from that format into official product documentation. Finally, we plan to package that up in such a way that you know exactly whose throat you get to choke when you buy support.
If only the middle step were easier to automate. It would be nice to have an open source WikiText-to-OpenDocument-format conversion tool.