From: Brian M. <br...@gr...> - 2008-03-13 21:27:18
|
Jim, > And here are a couple of incidental suggestions: > > - avoid grouping unrelated changes; better to divide > into separate > commits for the following reasons: a better log > entry; easier > troubleshooting/reverting. (and probably more). > > - similar to above, it may be better to make small > incremental changes > than one big one (if possible). Interim changes > should not introduce > breakage, of course. > > - logs are important -- please give some thought to > the log message: the > ideal first sentence would be short, meaningful, and > suggestive. Include > a tracker issue #NNNN there, if appropriate. > Additional explanation is > encouraged if it would be something you yourself > would appreciate when > reading it six months from now. If relevant, > emphasize impact of change > from user's point of view. > > ..well, those are my self-reminders anyway. Others > may have other ways > of saying it or other things to emphasize. > > Regards, > ..jim All good stuff. It would be even better on the Wiki ;) |