John, why don't you pop on over to dev@? We're on the cusp of getting docs into CouchDB proper. We've also talked about teams. We only really have one team at the moment (the release team) but a docs team would be fantastic.
On Sun, Sep 9, 2012 at 4:14 PM, john.tiger <[email protected]>wrote: > we like couchdb but the most frustrating part of trying to use it is the > poor state of documentation (this is not a criticism, just how we find the > current state) - there are some docs but they are scattered all over the > place and hard to follow or find. (ie we are trying to find any docs or > tuts on the security features as of 1.20 - cannot find it aside from the > "what's new" notes and the security chapter in the definitive guide based > on 0.11) > > how can we help to get this organized better ? right now it does not > appear that any docs are downloaded with the source - what is the > "official" documentation ? roadmap ? there is a wiki, user guide, api > listing, the definitive guide book project, some good tutorials but across > various versions (especially on couch app, planet couch (which seems non > active), much good info in the users forum that could be posted in docs, > just a couple of brief posts on jquery.couch, ....... There is not even a > menu button for documentation on the home page ! > > is there any sort of "team" for docs ? if not, let's create one. is > there an "official" place for any existing or new documentation ? if not, > let's assign it or create it along with easy instructions on how to > contribute (contributions are sorely needed). > > so a) I hope the "core" team can recognize/accept the fact the docs needs > lots of work and b) we are offering to help and I hope the core team is > willing to accept some outside help on this. > > so if yes to both, first order is to create a docs team (that can make > decisions on what goes where, review contributions, ...) and then create a > docs roadmap > -- NS
