Matthew Talbert wrote:

I subscribe to sword-svn as an attempt to educate myself on the
library, and, of course, to keep track of current changes. It would be
a real help to me if the commit messages were longer and more
informative. As I am very new to a lot of the engine stuff, it is hard
to tell just by looking at the commits what problem they are
attempting to solve.

+1

I've not (yet?) subscribed to sword-svn, but I have grabbed the svn tree and looked through svn log to see what has been changing and why. Like you, I found the commit messages somewhat cryptic.

Ideally, I think bugs and enhancements would appear and be described in a bug tracker, and then VCS commit msgs can include something like (Fixes: #12345) so that there is a pointer to more verbose info on the "why" of any given change. While I'd love to see something like that for SWORD, I don't know if that approach is reasonable/feasible for the SWORD developers, and it is their code, not mine -- at this point I am very much just a "lurker" when it comes to that code :)

Jonathan


_______________________________________________
sword-devel mailing list: sword-devel@crosswire.org
http://www.crosswire.org/mailman/listinfo/sword-devel
Instructions to unsubscribe/change your settings at above page

Reply via email to