[Bf-committers] comments/notes in commit logs AND source

[Luis de Bethencourt]

that should be done to both new and old code. talking from a "trying to
learn how blender does things" stage.
    luis

On 3/27/06, Ken Hughes <khughes at pacific.edu> wrote:
>
> Martin Poirier wrote:
> > Please, when you commit code in places where you are
> > not the maintainer, at least add some technical change
> > notes to the commit log (at best, go through the patch
> > tracker, of course).
> >
> > It's harder to maintain code which I haven't done,
> > just imagine what happens when people drop some in
> > without warning and without docs.
>
> I'll second that, plus add a suggestion for everybody (maintainer or
> otherwise): add some comments to the code to describe what it does.  It
> really helps newcomers when they're trying to learn how blender does
> things, not to mention reminds you what you had in mind when you coded it.
>
> Ken
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at projects.blender.org
> http://projects.blender.org/mailman/listinfo/bf-committers
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://projects.blender.org/pipermail/bf-committers/attachments/20060328/a9028305/attachment.html