Mailing-List: contact commits-help@cassandra.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cassandra.apache.org
Date: Sat, 19 Jan 2013 00:14:13 +0000 (UTC)
From: "Eric Evans (JIRA)" <jira@apache.org>
To: commits@cassandra.apache.org
Message-ID: <JIRA.12627450.1358178868734.162700.1358554453108@arcas>
In-Reply-To: <JIRA.12627450.1358178868734@arcas>
References: <JIRA.12627450.1358178868734@arcas>
Subject: [jira] [Commented] (CASSANDRA-5156) CQL: loosen useless versioning
 constraint
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/CASSANDRA-5156?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13557790#comment-13557790 ] 

Eric Evans commented on CASSANDRA-5156:
---------------------------------------

bq. Well, you do switch arguments . I though we agree initially that semver was probably overkill for us with your "As for the patch version (Z), I think you're right. I doesn't offer much value". So I was mainly arguing that even if don't follow http://semver.org/, I'd still rather keep a 3 number version rather than 2.

I don't think I switched arguments.  I assumed that at least one of your suggestions was to drop the patch version (Z), and that seemed reasonable to me on the basis that it would be easier to keep up with.  I realize now that wasn't the case; Sorry for the confusion
                
> CQL: loosen useless versioning constraint
> -----------------------------------------
>
>                 Key: CASSANDRA-5156
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-5156
>             Project: Cassandra
>          Issue Type: Improvement
>            Reporter: Sylvain Lebresne
>            Assignee: Sylvain Lebresne
>            Priority: Trivial
>             Fix For: 1.2.1
>
>         Attachments: 5156.txt
>
>
> So far the CQL doc says the CQL language follows http://semver.org/. Meaning that a version is X.Y.Z where:
> * X is the major version and denotes backward incompatible changes
> * Y is the minor version and denotes backward compatible changes
> * Z is the patch version and denotes backward *and* forward compatible changes, i.e. change to the implementation.
> Now I don't think for CQL we have much use of the patch version. Not that knowing when implementation fixes have been done is not useful but:
> # The Cassandra version number already kind of cover that.
> # While a patch version would be more precise in that it would only concern CQL3 related changes, I have no illusion on our capacity in maintaining such patch version accuratly (and frankly, I don't blame us).
> So instead of keeping a number that will end up having no usefulness whatsoever, I suggest that we either:
> # remove it and have CQL3 version being just major and minor.
> # use that latter number as a sub-minor version, i.e. a version that only
> # denotes backward compatible changes, not forward ones. We would then bump the two last digit at our discretion, to denote some form of "importance" of the changes.
> I don't care much about which of the two we end up doing, but since we already have a 3 numbers version and since I kind of like the idea of having two numbers to convey a sense of importance of the changes, I'm attaching a patch for the 2nd solution.
> Note that the patch removes the changes section from the doc, but that's because I think it's useless in it's current form (on top of being inaccurate).  I do plan on adding a new changes section that lists changes between CQL minor version as soon as we have some of those.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira