[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: svn commit: r1494829 - /subversion/site/publish/docs/release-notes/1.8.html

From: Ivan Zhakov <ivan_at_visualsvn.com>
Date: Thu, 20 Jun 2013 16:44:42 +0400

On Thu, Jun 20, 2013 at 4:40 PM, C. Michael Pilato <cmpilato_at_collab.net> wrote:
> On 06/20/2013 06:55 AM, Johan Corveleyn wrote:
>> Fine for me. I actually don't care about this personally (at our
>> workplace we're still lightyears away from upgrading, both client and
>> server side). I just found it to be an important omission from our
>> release notes (that actually should have been included way before
>> release), and thought the information good enough, and at least better
>> than nothing. But if people object, no problem.
>
> Note that there is often some benefit to *not* pointing out every single
> feature or toggle we add. In this case (as in the case of the
> http-max-connections configuration option), I intentionally left these out
> of the release notes. Why? Because I don't want folks reading those notes
> to feel as if they *have* to fiddle with every knob simply because it
> exists, and the default behaviors here should be sufficient.
>
> Remember, the release notes aren't *the documentation*, and as such, they
> needn't be exhaustive. They exist to advertise the benefits and (where
> applicable) "gotchas" of the release, primarily for the benefit of people
> who are existing Subversion users looking to upgrade to the new version.
>
Big +1. HTTP protocol options added mostly for debugging purpose, not
for regular users.

-- 
Ivan Zhakov
CTO | VisualSVN | http://www.visualsvn.com
Received on 2013-06-20 14:45:34 CEST

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.