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 83E05109BB for ; Thu, 26 Sep 2013 09:03:37 +0000 (UTC) Received: (qmail 48685 invoked by uid 500); 26 Sep 2013 09:03:35 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 48465 invoked by uid 500); 26 Sep 2013 09:03: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 48450 invoked by uid 99); 26 Sep 2013 09:03:34 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 26 Sep 2013 09:03:34 +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 (nike.apache.org: domain of mainerror@gmail.com designates 209.85.212.172 as permitted sender) Received: from [209.85.212.172] (HELO mail-wi0-f172.google.com) (209.85.212.172) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 26 Sep 2013 09:03:28 +0000 Received: by mail-wi0-f172.google.com with SMTP id hn9so6699792wib.17 for ; Thu, 26 Sep 2013 02:03:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:content-type; bh=fpJ+ApLP60q5L7Rg3SQlovDfAc1grir33CKtr8Q0uIQ=; b=ceO/bJdlESBS3l89qQ1RfkBEYBOJyW+Vv8ENTIhl0QvGiUZYPW5y4gASeyzbnLtdKe vyRsUyVBShRXNtsH+tXT+sbfUHYnZZRI9tdd33WmWpY8AGdjLLyJyEwT0kPoDYWbBdld YWfm+TnweUvCc0RxUGw5TSp9Wwjbp80FhGnCDSDRC3LSTf/mBVKXiYGli74H5Fj55q7C tVPNuUEVr7YwTjWutG3ELZSJRJl7bR8/4649J/gdWLsG9gToZNvnnCIl2z/ER3RfJVjS Chfjrk24qyIOocsbPXOWB2EPWbprnRhrKE+s4SIa2J+bS5AHCNg2S8GVhtvmgbIOONp3 sNnw== MIME-Version: 1.0 X-Received: by 10.180.189.49 with SMTP id gf17mr26224922wic.23.1380186188214; Thu, 26 Sep 2013 02:03:08 -0700 (PDT) Sender: mainerror@gmail.com Received: by 10.194.138.107 with HTTP; Thu, 26 Sep 2013 02:03:08 -0700 (PDT) In-Reply-To: References: Date: Thu, 26 Sep 2013 11:03:08 +0200 X-Google-Sender-Auth: VEvcKVY5o3qymqZRbMDCy1mMwAQ Message-ID: Subject: Re: [DISCUSS] push minor doc improvements/additions directly to release branches From: Octavian Damiean To: dev@couchdb.apache.org Content-Type: multipart/alternative; boundary=001a11c33fd078f69404e745a368 X-Virus-Checked: Checked by ClamAV on apache.org --001a11c33fd078f69404e745a368 Content-Type: text/plain; charset=UTF-8 +1. Docs with minor issues trumps bad docs. On Thu, Sep 26, 2013 at 10:57 AM, Garren Smith wrote: > +1 I agree, SHIP ALL THE DOCS!!!! > > > On 25 Sep 2013, at 11:46 PM, Dave Cottlehuber wrote: > > >> On Wed, Sep 25, 2013 at 9:04 PM, Dave Cottlehuber wrote: > >>> Would there be any objections to pushing minor doc fixes & additions > directly to master? > >> > >> No! In fact, I was doing that already even before 1.3.1 came out, I > think. > >> > >>> The quicker we can get updates out into docs.couchdb.org, the better. > >>> > >>> To be clear, I'm not suggesting that major changes like Alex's branch > should just go straight in. > >> > >> We talked about this in IRC today, but I'll reiterate here for those > >> who missed that: I think Alex's work on the docs branch is awesome, > >> but I feel like the branch has dragged on for way too long. This means > >> uncounted users have gotten worse documentation than they could have > >> gotten, because we were still tweaking some little thing or not quite > >> satisfied with the language somewhere. While this kind of thing can be > >> unavoidable with code, where there's much more complexity to deal > >> with, documentation isn't like that, and we shouldn't treat it like > >> that. Documentation patches should go straight to master or on very > >> short-lived feature branches. > >> > >> Cheers, > >> > >> Dirkjan > >> > > > > +1 to that. Dirkjan's right, and it's past time for the superb work Alex > has put in to make the light of day :-) > > > > SHIP ALL THE DOCS! > > > > > > -- Octavian Damiean GitHub: https://github.com/mainerror --001a11c33fd078f69404e745a368--