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 EEFE9D25C for ; Tue, 31 Jul 2012 15:29:36 +0000 (UTC) Received: (qmail 62951 invoked by uid 500); 31 Jul 2012 15:29:35 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 62913 invoked by uid 500); 31 Jul 2012 15:29:35 -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 62843 invoked by uid 99); 31 Jul 2012 15:29:35 -0000 Received: from minotaur.apache.org (HELO minotaur.apache.org) (140.211.11.9) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 31 Jul 2012 15:29:35 +0000 Received: from localhost (HELO [192.168.1.5]) (127.0.0.1) (smtp-auth username rnewson, mechanism plain) by minotaur.apache.org (qpsmtpd/0.29) with ESMTP; Tue, 31 Jul 2012 15:29:35 +0000 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Apple Message framework v1278) Subject: Re: Docs, second try From: Robert Newson In-Reply-To: Date: Tue, 31 Jul 2012 16:29:33 +0100 Content-Transfer-Encoding: quoted-printable Message-Id: References: <8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org> <19EB8367-1282-4406-9C51-B3AE4AFA0080@apache.org> <2E5C3210-58B9-48A7-9E21-3B6206D24899@apache.org> <382956416E9B4787895A95D59AC5ECC1@cloudant.com> <70658AB3-81FA-4E3A-ABE6-D6299ED2704A@apache.org> <436CC93B-6244-4A01-9933-46B2937AB331@apache.org> <872CBFC9-B758-492C-8297-410600E6DA84@tumbolia.org> <15663FC5-C39A-480E-90F3-DE29A90B51CC@apache.org> <141BD7F5-CCBB-4DFA-A8D7-8D0E58A9FCB4@apache.org> To: dev@couchdb.apache.org X-Mailer: Apple Mail (2.1278) Benoit, what sort of effort would be involved in that switch? Am I right = that the toolchain for building the docs would be wholly Python? B. On 31 Jul 2012, at 15:38, Dirkjan Ochtman wrote: > On Tue, Jul 31, 2012 at 4:01 PM, Robert Newson = wrote: >> Those are all good points, thanks. I haven't used Sphinx, is it = popular? Are there any other choices? >=20 > It's quite popular. Look at readthedocs.org (free Sphinx hosting) or > the Python documentation for some examples. >=20 > Using Sphinx/reST would definitely make it easier for me to finally > contribute more to CouchDB, whereas DocBook would definitely not. >=20 > Cheers, >=20 > Dirkjan