Re: GRASP (was Re: This is a simple question)

[Matthew Woodcraft <mattheww@chiark.greenend.org.uk>]

Simon Wright <simon.j.wright@amsjv.com> writes:

> James Rogers <jimmaureenrogers@worldnet.att.net> writes:
> 
> > This might have revealed a limitation of the process you used.  I
> > have found it both reasonable and helpful to document all changes in
> > comments. Source code control systems may be able to identify many
> > changes. They cannot identify the reasons for the changes. The
> > changes should be a response to a documented requirement.

[...] 
 
> I completely agree that you need to document the reasons for change,
> in the VC log works for me. The concept of "documented requirement"
> seems just slightly foreign to that of "volunteer open-source
> project", though!

I don't see why it should be. You'd have to let the volunteer
developers write their own requirements, of course, but there's
nothing to stop a project only accepting code if they do so.

-M-