Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (nike.apache.org: domain of djc.ochtman@gmail.com
 designates 209.85.212.176 as permitted sender)
MIME-Version: 1.0
Sender: djc.ochtman@gmail.com
In-Reply-To: 
 <CAJNb-9o7nKtt0uSVYkvZUYTGRKYpXTBM-yaKabD1=hHDFswQqg@mail.gmail.com>
References: <EC73BB16-F86A-4F6B-9143-A22B88381108@apache.org>
 <8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org>
 <19EB8367-1282-4406-9C51-B3AE4AFA0080@apache.org>
 <D5FEC7AA-2294-41F5-81E9-AF982BF29976@apache.org>
 <2E5C3210-58B9-48A7-9E21-3B6206D24899@apache.org>
 <382956416E9B4787895A95D59AC5ECC1@cloudant.com>
 <70658AB3-81FA-4E3A-ABE6-D6299ED2704A@apache.org>
 <E2D5A5F1B3794024BBEC5AD03852711F@cloudant.com>
 <436CC93B-6244-4A01-9933-46B2937AB331@apache.org>
 <FF69394627DB40C0BFE9CBC7AE253631@cloudant.com>
 <872CBFC9-B758-492C-8297-410600E6DA84@tumbolia.org>
 <BD8ECF010F6E41C4A5F69DA433E09A6C@cloudant.com>
 <CAHZBNKb-+V6qn=eNnmKyLTZfh32QvFj=CnY_JPHdm3s--dBzLw@mail.gmail.com>
 <CAJNb-9rMGryj13gLJXqcmirc-6kRjNjT9YocCmyFmfcuipO4OQ@mail.gmail.com>
 <15663FC5-C39A-480E-90F3-DE29A90B51CC@apache.org>
 <CAJNb-9ozBHXK8t9neyr-K=9dQA9TvKPQpyX5Lp0Ss4Sqq_8mWA@mail.gmail.com>
 <141BD7F5-CCBB-4DFA-A8D7-8D0E58A9FCB4@apache.org>
 <CAKmKYaC_8nuahD4q=DAUC5BTJ58iCsiwfh+CBMB6ZcnGHTX1RQ@mail.gmail.com>
 <29AACC7D6BF74C14BC1AB920E643AA56@cloudant.com>
 <CAKmKYaBoazt-OCeLgR6q9GUka8SJcKiV4Ego7Nxx7Knp+EhE0g@mail.gmail.com>
 <CAJNb-9p6n67-UuEKxB4mbFo22X3ckF=FWtYGhCqXowgZAwmPMQ@mail.gmail.com>
 <6B233E41-1CC5-49A1-966D-DC2912D6CC8B@tumbolia.org>
 <CAJNb-9o8nHt0OqmZvH4A+sAxNSqkR3COH7ugTMw0_LQ=65wO2A@mail.gmail.com>
 <CA+Y+446th8T---VWZWc21yei=M_cKf0bU51tiNAkra+RXa5MEQ@mail.gmail.com>
 <CAHZBNKY8TLYZsmFpRYeuZGhaZS7yR1T5fu3WNRmVt55+V8sKNw@mail.gmail.com>
 <CAKmKYaAjOHZaNezQoWoJ_qPFbPB673unBnZELRnegdQDkkiygA@mail.gmail.com>
 <CA+Y+447V5pZ3kDOZr3GeNRL6_0WEQSq1QKHpG_wVoHrAsbDtAQ@mail.gmail.com>
 <CAKmKYaC--rxBa7=z957LiM=eP7=KG9h0uyjKyUweH__P4m1Y1g@mail.gmail.com>
 <CA+Y+446wp0iPapzx5hEkFzcVd6ENb9mZpWWR2rTXMcGX7XhsPg@mail.gmail.com>
 <CAJNb-9o7nKtt0uSVYkvZUYTGRKYpXTBM-yaKabD1=hHDFswQqg@mail.gmail.com>
From: Dirkjan Ochtman <dirkjan@ochtman.nl>
Date: Fri, 3 Aug 2012 09:08:33 +0200
Message-ID: 
 <CAKmKYaAyaZt3Ks2S5wkMG_UYvT2ehw2hcFFa90Wi-aR7=rMdZg@mail.gmail.com>
Subject: Re: Docs, second try
To: dev@couchdb.apache.org
Content-Type: text/plain; charset=UTF-8

On Fri, Aug 3, 2012 at 5:47 AM, Benoit Chesneau <bchesneau@gmail.com> wrote:
> I'm trying to summarize the actions we need to put in place here:
>
> 1. create the doc branch , start to track the process of the
> conversion to make sure we didn't lost an information.

I have a docs branch working on this:
https://github.com/djco/couchdb/commits/docs

> 2. hack the autotools to handle this makefile and the needed check

I can make a start with that, but Noah will take it further as needed.

> 3. hoock it to git? (can we do that actually on the apache website)

I've set this up for readthedocs.org (hook from my branch, mentioned
above), we can switch that later.

> Where do we host the doc?

I'll leave that to the committers. readthedocs.org works nicely,
though, will let you do automatic updating using a hook, and I think
can do custom domains.

> Where do we place the donated docs?

The consensus in IRC was that they would remain in the repository
history of the docs branch, but not in new commits once the Sphinx
conversion is complete.

Cheers,

Dirkjan