Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (athena.apache.org: domain of dch@jsonified.com designates
 209.85.214.52 as permitted sender)
Date: Wed, 25 Sep 2013 23:46:55 +0200
From: Dave Cottlehuber <dch@jsonified.com>
To: dev@couchdb.apache.org
Message-ID: <etPan.524359cf.238e1f29.3d7e@akai.jsonified.com>
In-Reply-To: 
 <CAKmKYaC=9yydJCThvPmJdqDcrKsPCBXAC85YhBRB9k=YpWTQUQ@mail.gmail.com>
References: <etPan.524333c4.6b8b4567.3d7e@akai.jsonified.com>
 <CAKmKYaC=9yydJCThvPmJdqDcrKsPCBXAC85YhBRB9k=YpWTQUQ@mail.gmail.com>
Subject: Re: [DISCUSS] push minor doc improvements/additions directly to
 release branches
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

>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!