incubator-cassandra-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Eric Evans <eev...@rackspace.com>
Subject Re: API versioning
Date Wed, 06 Jan 2010 22:55:48 GMT
On Wed, 2010-01-06 at 16:33 -0600, Denny Abraham wrote:
> This seems similar enough to the semantic versioning spec
> http://semver.org/. (minus the third value) that it may be convenient
> and worthwhile to implement the full spec. 

The third value here is for "backward compatible bug fixes", (as others
here have suggested). The wording on the page eludes to changes that
"fix incorrect behavior", or "these are changes that could create
problems if the library relied on buggy behavior" (my words).

I can get on board with that.

So that would make, x.y.z where x is major, y is minor, and z is patch
level. The major is bumped for breaking changes, the minor is bumped for
changes in features or functionality that are backward compatible, and
the patch level is bumped for every other change.

-- 
Eric Evans
eevans@rackspace.com


Mime
View raw message