Return-Path: X-Original-To: apmail-couchdb-dev-archive@www.apache.org Delivered-To: apmail-couchdb-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 40A9F6B81 for ; Mon, 4 Jul 2011 15:48:52 +0000 (UTC) Received: (qmail 82240 invoked by uid 500); 4 Jul 2011 15:48:51 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 82179 invoked by uid 500); 4 Jul 2011 15:48:51 -0000 Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@couchdb.apache.org Delivered-To: mailing list dev@couchdb.apache.org Received: (qmail 82168 invoked by uid 99); 4 Jul 2011 15:48:50 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 04 Jul 2011 15:48:50 +0000 X-ASF-Spam-Status: No, hits=-0.7 required=5.0 tests=FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of klimpong@gmail.com designates 209.85.213.52 as permitted sender) Received: from [209.85.213.52] (HELO mail-yw0-f52.google.com) (209.85.213.52) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 04 Jul 2011 15:48:44 +0000 Received: by ywo7 with SMTP id 7so3684275ywo.11 for ; Mon, 04 Jul 2011 08:48:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:reply-to:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; bh=apyJnZ1il0QFUO25tQ9XJE+Qv64tmbGm6b+fREsqBRQ=; b=eDH47CvAeNQtZJUt0lt7xLSRR6FGJ72NuLYOQrR0DcWPLkLAQnUzi5Km3a37oADIFr TM/hXDY6XG5TH+F3o4dlOwANE6986r0u1tNBgtqfegzoFO1jAb3+y9BkYZNuy93mO5fn Yi4ew7DxPRnYo6BNrYZpguGhoBbBmOdYevGuo= MIME-Version: 1.0 Received: by 10.236.77.132 with SMTP id d4mr2279307yhe.398.1309794503850; Mon, 04 Jul 2011 08:48:23 -0700 (PDT) Reply-To: till@php.net Sender: klimpong@gmail.com Received: by 10.236.47.167 with HTTP; Mon, 4 Jul 2011 08:48:23 -0700 (PDT) In-Reply-To: References: <20110704122846.47128.6820@eos.apache.org> <3CE5C87A-0FA1-4134-8FE8-7AF7EEAA43C8@apache.org> <6F2768E7-D444-42D8-8856-F169B954AC6B@echolibre.com> <174DA42E-2C72-4AC4-9579-4041E386E3AD@apache.org> <99A730F2-F5B4-4F69-B79C-E11CAE0AA92A@echolibre.com> Date: Mon, 4 Jul 2011 17:48:23 +0200 X-Google-Sender-Auth: SeOr6QoVSQxiTvwJtyqjEkC0F7g Message-ID: Subject: Re: [Couchdb Wiki] Update of "CouchDB_in_the_wild" by JohnDorion From: till To: Robert Newson Cc: dev@couchdb.apache.org Content-Type: text/plain; charset=ISO-8859-1 X-Virus-Checked: Checked by ClamAV on apache.org 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 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 wrote: >> On Mon, Jul 4, 2011 at 5:09 PM, Noah Slater 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 >> >