All good questions -- for a different thread
On 4 July 2011 16:48, till <[email protected]> wrote: > Would that documentation be in 'any' VCS, or specifically in > http://svn.apache.org/viewvc/couchdb/? > > Also, what format would it be in? Any thoughts yet? > > On Mon, Jul 4, 2011 at 5:40 PM, Robert Newson <[email protected]> wrote: >> till, >> >> The idea is essentially that we move docs into the source tree, which >> immediately protects them from spam at the cost of preventing edits >> from the public. >> >> These docs would include full API documentation as well as a tutorial >> or howto guide. >> >> It's long past time we had this kind of documentation under source >> control and not mixed in with the highly variable wiki. The presence >> of good documentation in the wiki gives the whole wiki an unwarranted >> stamp of approval. I would like to be able to point at definitive >> documentation at couchdb.apache.org rather than the wiki, which can >> then be freed to *only* include things that the documentation does >> not. >> >> B. >> >> On 4 July 2011 16:34, till <[email protected]> wrote: >>> On Mon, Jul 4, 2011 at 5:09 PM, Noah Slater <[email protected]> wrote: >>>> >>>> On 4 Jul 2011, at 15:46, Robert Newson wrote: >>>> >>>>> (but, hey, wikis are new, bound to be bugs). >>>> >>>> LOL >>>> >>> >>> HAHA... Nice. >>> >>> I can't find find the other wiki thread. What's the idea documentation >>> wise, is there anyone working on something else, or so. I'd like to >>> either do something, or at least support an ongoing effort. >>> >>> Till >>> >> >
