On Nov 27, 2006, at 1:52 PM, Joe Bohn wrote:
> I agree with Jason that the change log should include a list of
> changes rather than problem statements. After all, it is a
> *change* log and not a *problem* log. :-) Just a brief summary of
> the change is all that's needed and I personally find this much
> more helpful than a one line description of a problem taken from
> the JIRA. Of course, the description should also include a
> reference to the JIRA.
Yup.
> I also agree with Donald (and I suspect Jason does too) that the
> JIRA is the right place for all the gory details on the problem and
> solution.
Yup.
> So, can we agree to keep the details in the JIRA but have a brief
> descriptive statement of what changed in the commit log rather than
> a statement of the problem?
Hope so ;-)
--jason
|