From dev-return-22756-apmail-couchdb-dev-archive=couchdb.apache.org@couchdb.apache.org Mon Jul 30 16:42:21 2012 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 54EC298A5 for ; Mon, 30 Jul 2012 16:42:21 +0000 (UTC) Received: (qmail 53314 invoked by uid 500); 30 Jul 2012 16:42:20 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 53281 invoked by uid 500); 30 Jul 2012 16:42:20 -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 53271 invoked by uid 99); 30 Jul 2012 16:42:20 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 30 Jul 2012 16:42:20 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of simon@cloudant.com designates 209.85.212.182 as permitted sender) Received: from [209.85.212.182] (HELO mail-wi0-f182.google.com) (209.85.212.182) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 30 Jul 2012 16:42:12 +0000 Received: by wibhq12 with SMTP id hq12so1501253wib.5 for ; Mon, 30 Jul 2012 09:41:51 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=date:from:to:message-id:in-reply-to:references:subject:x-mailer :mime-version:content-type:x-gm-message-state; bh=qpT2U4DsKIzp1S36ZX+mw1nTgANMKIM+oumP4n4b0Is=; b=edrk2UVFaNyAwdCea0lNcSGl9jDXsJoMu97fSwnyG82MbiaLnUnUHrKm6uML3v9BfZ RQwZACCIsx/XeiARncKufjh3OUe9z1IOuIjtoCftwO4wKIxzV3ifbo2A1VuAMqhsv+Fi la8yFlObC3tCini/8eBK0kxRc4YHmB7tKrM0VO3Hn6ZMZk4Ap0btZkUyHpaLQ0ny1oAZ KGQ0Z2pGd6CGg5JpN0y65WPuMpy6TbWXNnHYG00wfBNkCuzqzUkJP8rNvVDsV4J7E/O/ 0A7eM4GJrpNki8n2eN5XMBPDW1jyzOgZmZIxlFGVj7YSAGDEeDSai0cLv7iGTTQminoS iKCw== Received: by 10.180.100.133 with SMTP id ey5mr27989627wib.4.1343666511261; Mon, 30 Jul 2012 09:41:51 -0700 (PDT) Received: from [192.168.1.73] (host86-181-233-50.range86-181.btcentralplus.com. [86.181.233.50]) by mx.google.com with ESMTPS id ck9sm25383633wib.2.2012.07.30.09.41.49 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 30 Jul 2012 09:41:50 -0700 (PDT) Date: Mon, 30 Jul 2012 17:41:48 +0100 From: Simon Metson To: dev@couchdb.apache.org Message-ID: In-Reply-To: <872CBFC9-B758-492C-8297-410600E6DA84@tumbolia.org> 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> Subject: Re: Docs, second try X-Mailer: sparrow 1.6.2 (build 1143.6) MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="5016b94c_579be4f1_b6c3" X-Gm-Message-State: ALoCoQnW4Zgw9XD/IRz4ZsSxwf2eoOVBJTFsX1eTYAQghZN2Y2Q4KUsTH/DhffTqw7oNA4JL57WY X-Virus-Checked: Checked by ClamAV on apache.org --5016b94c_579be4f1_b6c3 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Content-Disposition: inline Hi, Has this moved on at all? Thinking about it a bit more (off and on) I'm inclined to suggest that DocBook isn't the greatest format. If we stored the docs in markdown it would be easier for people to edit/contribute (they could view the docs and make changes in github without having to compile/install anything). I'm happy to put some cycles into converting whats there to a bunch of markdown. Rendering that in futon is pretty easy too. I can see the benefits of DocBook for writing a book, but I'm not sure that its what's needed here - it seems like using a hammer to crack a nut. Cheers Simon On Thursday, 21 June 2012 at 21:25, Noah Slater wrote: > I am publicly taking ownership of this project, and will run point on it. > > I've not contributed code to CouchDB for a while, and my free personal time is scarce, but I am in the best position to do this work. I know Autotools and DocBook very well, and have integrated them in the past. > --5016b94c_579be4f1_b6c3--