To add here, regarding component breakout:
* When a component is moved out of a monolithic structure, do a check to
strip out extraneous dependencies. For instance, references to JBoss
Logging/SPI/Common.
S,
ALR
Dimitris Andreadis wrote:
I know it is tedious for smaller broken out project JIRAs to be in
sync
with the code/releases, especially when the initial Betas are still in
progress (e.g.
http://jira.jboss.com/jira/browse/JBVFS) *but* when this
stuff reaches a state that will need to be supported, it will be very
hard to track what went into a release, unless we maintain some
discipline, i.e. the obvious stuff: don't commit without a linked JIRA
task and properly mark versions as released.
Something else to avoid is using "foreign" JIRA tags in commit message.
E.g like JBCTS / JBWS / JBPAPP / ... tags in community AS
branches/trunk, rather use JBAS tag that link back to the other projects.
Finally, the more projects are broken out into smaller ones (with their
own JIRA, etc) the more difficult it becomes to assemble meaningful
release notes, and many users have complained about that.
My proposal would be that for every updated component (or set of
components if they are tracked together):
1) there should be a JIRA task to track the upgrade, e.g. when upgrading
the jbosssx libs.
2) this JIRA should either embed or link to the release notes of the
upgraded component
3) the task should be re-used if upgrading multiple times within the
same target release
4) the rule would apply for both jboss and thirdparty libraries
This is something I'm trying to enforce for upgrades I'm doing myself,
but it would be great to have a wider consensus / application of this
practice.
I would also like to propose that we introduce a new JIRA type next to
'feature', 'bug', etc. called e.g. 'Component Upgrade' to mark
those
JIRA tasks. By doing so, the component upgrades:
- would immediately stand out in the release notes report
- the user will be able to drill-into the jira task and find out exactly
what the upgrade is about.
That would be quite simple and effective, I think.
Thoughts?
/Dimitris
--
Andrew Lee Rubinger
Sr. Software Engineer
JBoss EJB3
JBoss, a division of Red Hat, Inc.
http://labs.jboss.com/jbossejb3/
http://exitcondition.alrubinger.com