[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: C. Michael Pilato <cmpilato_at_collab.net>
Date: Thu, 20 Jun 2013 08:40:14 -0400

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.

C. Michael Pilato <cmpilato_at_collab.net>
CollabNet   <>   www.collab.net   <>   Enterprise Cloud Development

Received on 2013-06-20 14:40:49 CEST

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