Tagging/branching of JBoss Tools Core subcomponents

Version 6

    Our recent move to git caused some confusion on how we tag/branch components in JBoss Tools core components.

     

    Current Tag/Branching strategy

     

    To avoid future confusion here are the short version of the current approach:

     

    • Each component has its own version in manifest.mf/pom.xml/feature.xml
      • This can be set quickly using mvn -Dtycho.mode=maven org.sonatype.tycho:tycho-versions-plugin:set-version -DnewVersion=1.2.3-SNAPSHOT


    • The git repositories should use tag/branches based on jbosstools version:
      • Branches: jbosstools-<version>x ("x" used to differentiate a branch from a tag)
      • Tags:            jbosstools-<version> (no "x" suffix)

     

    • In Jira use the jbosstools version for reporting/targeting issues.

     

    The advantage to the above is that git & jira use the same version. i.e. with a unified tag like "jbosstools-4.1.0.Alpha1" you can find which version is used of a specific component for a specific jboss tools release easily.

     

    This means from git you always know which branch/tag to checkout for a component to get matching version to a specific jboss tools core build/release.

     

    With Jira we would need to introduce a project for each individual component since Jira does not support version per components and thus jira queries for knowing current status of JBIDE suddenly gets very complex.

     

    Discussion about improvements/future tagging can be found https://community.jboss.org/wiki/FutureStrategyForTaggingJBossToolsCore