couchdb-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Noah Slater <nsla...@tumbolia.org>
Subject Re: organizing docs
Date Sun, 09 Sep 2012 16:48:13 GMT
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 <john.tigernassau@gmail.com>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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message