Link your Commit to an ActionItem!

[Antonio Terceiro]

On Sun, Apr 13, 2014 at 10:39:33PM -0300, Aurélio Heckert wrote:
> Hi people,
> 
> I'm seen so many commits that have no message (description) and, the worst,
> have no reference to an ActionItem.
> 
> I don't believe all commits must refer to an ActionItem, but most of our
> work is related to a registered bug or feature request in noosfero project's
> tracker.
> 
> That is important because sometimes we must see a commit to understand why a
> line exists, and the commit message may do not tell enough.

I think this is the real problem: every commit message *must* describe
the change in a reasonable way *without* needing to refer to somewhere
else.

An action item reference must be an appendix, and one should not need to
go there to understand why a given change is being made.

-- 
Antonio Terceiro <terceiro at colivre.coop.br>
Colivre - Cooperativa de Tecnologias Livres
http://www.colivre.coop.br/


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: Digital signature
URL: <http://listas.softwarelivre.org/pipermail/noosfero-dev/attachments/20140414/1219b7f7/attachment.pgp>