couchdb-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "john.tiger" <>
Subject Re: organizing docs
Date Sun, 09 Sep 2012 17:17:07 GMT
On 09/09/2012 10:48 AM, Noah Slater wrote:
> 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.

thks - I'm running out the door and will be off-line until Tues

> On Sun, Sep 9, 2012 at 4:14 PM, john.tiger<>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

View raw message