cvs-news Kohsuke Kawaguchi October 2006

Agenda What's cvs-news? How it works? Why? What can it do today? What are planned?

What's cvs-news? Convention for CVS commit messages Machine readable It enables tools to extract information and do something useful for us We have a few tools to take advantage of this today Web UI http://cvs-news.sfbay/ http://cvs-news.glassfishwiki.org/ Library to parse commit messages

What's cvs-news?

How it works? When a developer commits a change, s/he puts a mark-up in the message, to make it a "news" Each news contains tags, title, and optional body Some tags are added automatically based on context User name Branch name Project name [NEWS:for-tango architecture] WSEndpointReference is refactored. WSEndpointReference class is refactored to achieve higher performance. Because of this change, a few methods are deprecated...

Why? To automate more Machine readable CVS commits can drive a lot of things Bug tracking system Continuous integration Publicizing projects Less overhead = more productivity To improve visibility for free Helps grow the community More things to show to people Reduces the communication overhead No more "when will your change go into Glassfish?" question

What can it do today? Simplify communication Often someone else is waiting for your change Use cvs-news instead of writing a separate e-mail Just commit and be done Benefits Interested party can subscribe via RSS or e- mail More detailed history information helps future development No more "I'm sorry, I forgot to CC to you" Example: a change in JAX-WS RI that affects Tango

What's being planned? Changelog generation for builds A tool to scan the commit messages, then automatically generate "list of noteworthy changes" Hudson integration Bi-directional links to find out which build contains the change Answers "Which WSIT build includes this JAXB fix?" Automatic issue tracker update When you put bug ID as a tag, the bug will be marked as fixed with cross-references

Conclusion Goal is for it to become a hub of our systems There's a lot of ways to take advantage of cvs- news Help wanted Please use cvs-news tags. It's really low overhead Please help me develop tools