[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
RE: [platform-ui-dev] Commit comment format for reporting of bugs

Mylar automatically generates similar commit comments.  I'm wondering if we
could come up with a standard format recommended across eclipse.org
projects.  On the Mylar project have been using a similar format for about a
year and are about to improve it as a result of our upcoming commit comment
templates (see attached screenshot, note that UI will be simplified).  Here
is what we're thinking of for the default format: 

  ${task.status}: {task.id}\n${task.url}

E.g.

  RESOLVED: 138666: [EditorMgmt] provide mechanism for restoring editors
  https://bugs.eclipse.org/bugs/show_bug.cgi?id=138666

This is too much to format by hand (e.g. the URL, which is useful for web
based tools such as Fisheye).  But it would be good for us to 'compatible'
with a manual format like the one proposed below.  However "Fix for" reads
awkwardly for enhancements.  So I wonder if you could consider making the
manual format something like the following, and then we could encourage
other Eclipse.org projects to adopt this approach and make it the basis of
the default template for Mylar.

  RESOLVED: bug 123: description

The status prefix could be optional, but can be convenient as discussed on:

117517: add support for commit comment templates
https://bugs.eclipse.org/bugs/show_bug.cgi?id=117517#28

Mik

> -----Original Message-----
> From: platform-ui-dev-bounces@xxxxxxxxxxx [mailto:platform-ui-dev-
> bounces@xxxxxxxxxxx] On Behalf Of Tod Creasey
> Sent: Wednesday, August 09, 2006 12:25 PM
> To: platform-ui-dev@xxxxxxxxxxx
> Subject: [platform-ui-dev] Commit comment format for reporting of bugs
> 
> As many of you have noticed the Platform UI team has been generating the
> list of fixed bugs each build and posting a message to this list after we
> submit the map file. This list is generated using the soon to be released
> "Generate Build Notes" option in the releng tool.
> 
> Any revision with a comment of the form Fix for Bug 12345 xxxx description
> will be used to generate this list which we hope will be a lot of help to
> the members of the  community who wish to track our work. Please be sure
> to use this format to ensure your fixes get reported. The easiest way to
> get this format is to copy the top line of Bugzilla report and to paste it
> into the commit dialog.
> 
> Tod
> _______________________________________________
> platform-ui-dev mailing list
> platform-ui-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/platform-ui-dev

Attachment: commit-templates.gif
Description: GIF image