From dev-return-9044-apmail-couchdb-dev-archive=couchdb.apache.org@couchdb.apache.org Sun Mar 07 14:51:43 2010 Return-Path: Delivered-To: apmail-couchdb-dev-archive@www.apache.org Received: (qmail 9304 invoked from network); 7 Mar 2010 14:51:43 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 7 Mar 2010 14:51:43 -0000 Received: (qmail 36214 invoked by uid 500); 7 Mar 2010 14:51:22 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 35979 invoked by uid 500); 7 Mar 2010 14:51:22 -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 35970 invoked by uid 99); 7 Mar 2010 14:51:22 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 07 Mar 2010 14:51:22 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=RCVD_IN_DNSWL_NONE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of dionne@dionne-associates.com designates 69.89.21.11 as permitted sender) Received: from [69.89.21.11] (HELO outbound-mail-01.bluehost.com) (69.89.21.11) by apache.org (qpsmtpd/0.29) with SMTP; Sun, 07 Mar 2010 14:51:14 +0000 Received: (qmail 23963 invoked by uid 0); 7 Mar 2010 14:50:51 -0000 Received: from unknown (HELO host183.hostmonster.com) (74.220.207.183) by cpoproxy1.bluehost.com with SMTP; 7 Mar 2010 14:50:51 -0000 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=dionne-associates.com; h=Received:Content-Type:Mime-Version:Subject:From:In-Reply-To:Date:Content-Transfer-Encoding:Message-Id:References:To:X-Mailer:X-Identified-User; b=IQI/keRa8lWrYfU3wO1+IVIGqO3MIq1aAXvP+kiEMYkwV7PziMzWFB7at5RTHHjM4ra8EIXX1Fyq3bjP9mIsnpnHdqtiEJx8nAcwGLmB210V9Z+xr/FGB0dRNStx3S0v; Received: from adsl-99-30-234-200.dsl.wlfrct.sbcglobal.net ([99.30.234.200] helo=[192.168.1.100]) by host183.hostmonster.com with esmtpa (Exim 4.69) (envelope-from ) id 1NoHoh-00069Z-48 for dev@couchdb.apache.org; Sun, 07 Mar 2010 07:50:51 -0700 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Apple Message framework v1077) Subject: Re: CouchDB Wiki / Documentation From: Robert Dionne In-Reply-To: Date: Sun, 7 Mar 2010 09:50:49 -0500 Content-Transfer-Encoding: quoted-printable Message-Id: <0DF94AE6-ECA2-465E-B56B-C7010B48D48B@dionne-associates.com> References: <0059D58E-A388-4B7A-B767-7E62154A1753@googlemail.com> <3B7C8CB9-727E-4566-8A38-EA19419AF988@tumbolia.org> <629B2A76-EF02-42DB-9492-99D29667E144@tumbolia.org> <7DC975DD-E6C1-41DA-B44C-9649CDD8B7A2@apache.org> <5D040A95-E355-41B8-A58A-437AFAA6226E@tumbolia.org> <30747dfa1003061624y21721ec4j3bb00db750b65b33@mail.gmail.com> <30747dfa1003061638j483a0551l6f3b1570f09d29d9@mail.gmail.com> <574E7F07-5474-4569-8F6A-D71155D02259@tumbolia.org> To: dev@couchdb.apache.org X-Mailer: Apple Mail (2.1077) X-Identified-User: {2551:host183.hostmonster.com:dionneas:dionne-associates.com} {sentby:smtp auth 99.30.234.200 authed with dionne@dionne-associates.com} X-Virus-Checked: Checked by ClamAV on apache.org On Mar 7, 2010, at 3:11 AM, J Chris Anderson wrote: >=20 > On Mar 6, 2010, at 4:47 PM, Noah Slater wrote: >=20 >>=20 >> On 7 Mar 2010, at 00:38, Mikeal Rogers wrote: >>=20 >>> We can provide the same providence and copyright assurances outside = of >>> JIRA. It's a checkbox, it's not hard. >>=20 >> I agree. I don't want to be misunderstood as fighting against the = initiative of improving our documentation. I just want to make sure we = do it in a way that embraces our parent organisation. And as far as I = know, and I am incorrect rather frequently, that involves hosting = whatever we use on ASF infrastructure, and taking the proper measures to = make sure that what is produced is free for the community to use, where = free is the ASF's definition of free. If we can satisfy that, and = improve our documentation, it will have my full support. However, just = creating a new repository on Github and linking to it from our site is = not satisfactory. >=20 > I think the short run, putting together an informal Markdown = repository of docs or proto-docs would be cool. I don't care where it = live but we'll need to get an ASF Zone for a project CouchDB instance. I = guess this means Damien has to send an email to infra. >=20 > It's simple to have CouchDB render Markdown. After 0.11 is out and we = launch the project CouchDB instance, I'm sure there are a ton of = CouchApps we could run it on that can handle Markdown. I really like the idea of this dogfood exercise. With respect to = Markdown, I'd like to also mention Org for those who are emacs users. It = can be used for everything from project management to publishing web = pages, journal articles, you name it. One can even embed LaTex in it. = For those who already know Org, markdown-mode[1] enables editing of = markdown with org style cycling, etc.. it can be published to any = format. I think the closer to doc stays to the code the more apt it is to be = read, written, and useful. I'm wondering how useful it might be to have = some of these markdown files reside with the code in the repository. [1] http://jblevins.org/projects/markdown-mode/ >=20 > Under ASF guidelines I'm pretty sure we don't need to worry about CLAs = for documentation contributors. Let's get the barrier to entry for new = documenters as low as possible. >=20 > Chris >=20 >=20