Grant, +1... Cheers, Chris
On Dec 6, 2010, at 7:42 AM, Grant Ingersoll wrote: > > On Dec 5, 2010, at 12:18 PM, Robert Muir wrote: > >> On Sun, Dec 5, 2010 at 12:08 PM, Mattmann, Chris A (388J) >> <[email protected]> wrote: >>> Hi Mark, >>> >>> RE: the credit system. JIRA provides a contribution report here, like this >>> one that I generated for Lucene 3.1: >>> >> >> My concern with this is that it leaves out important email contributors. > > I think we probably miss these as is too. > > <br/> > > Note, however, in my proposal, one can still call out specific things. We > could for instance have a "Contributors" section and just add names to it. I > just think we put too much minutiae in CHANGES and it is a real burden to > deal with it across branches b/c there are always massive conflicts and it > requires you to look up every last change to recall which version it is in. > IMO, JIRA should be the system of record for all bug discussions. > Discussions that happen on email can easily be pointed to using any one of > our many mail archive systems. > > Our new Changes could be structured like below. The important thing about > this approach is that it can all more or less be written at release time > other than the contributor list and perhaps the back compat section. > > </snip> > = Version X.Y = > > Brief Intro > > == Dependencies == > Junit 4.4 > > == New Features == > > * Magic search was implemented > > == Backward Compatibility Breaks == > > * Blah, blah, blah > > == Significant Changes == > > * We've replaced the inverted index with a giant array > > == Contributors == > (alphabetical order) > Joe Schmoe (optionally cite an issue number) > Jane Doe > > Optionally paste in the list from JIRA > > == Full Changes List == > > * LINK TO JIRA > </snip> > > > -Grant > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Chris Mattmann, Ph.D. Senior Computer Scientist NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA Office: 171-266B, Mailstop: 171-246 Email: [email protected] WWW: http://sunset.usc.edu/~mattmann/ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adjunct Assistant Professor, Computer Science Department University of Southern California, Los Angeles, CA 90089 USA ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
