[
https://issues.apache.org/jira/browse/CB-7774?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14171054#comment-14171054
]
ASF GitHub Bot commented on CB-7774:
------------------------------------
Github user mmocny commented on a diff in the pull request:
https://github.com/apache/cordova-coho/pull/53#discussion_r18835133
--- Diff: docs/versioning-and-release-strategy.md ---
@@ -19,17 +19,100 @@
#
-->
-# Versioning and Release Strategy
+# Versioning Strategy
-## Versioning Strategies
- 1. `SemVer` ([Semantic Version](http://www.semver.org))
- * Used by platforms, plugman, CLI, core plugins
- * Is important when describing dependencies in a sane way (e.g. within
plugin.xml files)
+## Version Format
-CLI exists in both lists because its version has the format:
`CadVer-SemVer`
- * E.g.: `3.0.0-0.5.1`
+`SemVer` ([Semantic Version](http://www.semver.org)) will be used as the
+version format for all components, including platforms, plugman, CLI, core
+plugins. Doing so is important when describing dependencies in a sane way
+(e.g. within plugin.xml files). Although the CLI previously used a
+`CadVer-SemVer` format, it now uses a simple SemVer format. The `CadVer`
format
+is no longer used in any Cordova components. The plugins no longer have an
`r`
+prefix.
-## Release Strategies
+The semantics of `SemVer` should be followed, bumping the appropriate digit
+based on the impact of the new content.
+
+## Branching and Tagging
+
+All components also follow the same branching and tagging strategy,
including
+plugins and tools. A `major.minor.X` release branch (i.e., "3.7.x") should
be
+created, and any fixes should be appended to that release branch. New
content
+should be on the master branch, and a new release branch created at release
+time. When a release is performed, a release tag is added to the
appropriate
+branch (i.e., "3.8.0" tag is put on the "3.8.x" branch).
+
+## Version Behavior
+
+Plugin versions will all be separate and independent. So there may be a
"1.2.0"
+of the Device plugin, and a "3.4.5" of the Camera plugin at the same time.
+The bumping of the version numbers of each plugin should be appropriate to
the
+new content added to that plugin. The `cordova plugin add` command will add
+the most recent version of that plugin by default, though alternately the
user
--- End diff --
This is correct as of today, but we would prefer to amend to say "most
recent *compatible* version". I know you are capturing today's behaviour here,
but just calling this out.
> update strategy for versioning
> ------------------------------
>
> Key: CB-7774
> URL: https://issues.apache.org/jira/browse/CB-7774
> Project: Apache Cordova
> Issue Type: Improvement
> Components: Coho
> Reporter: Marcel Kinard
>
> With the advent of independent platform releases, we need a strategy for how
> to version all the Cordova components.
> See http://markmail.org/message/zijjq4xe7wbbcwtg
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
