Presumably the impetus is that if you fix a bunch of small things in a single commit it might be easier to compile the list of small things you changed by noting them as comments as you fix them rather than trying to remember them after the fact when it comes time to write a commit log for that commit.
That said, philosophically I'd personally prefer to just commit the small features individually as a set of small commits, therefore you get a better git blame/praise experience with the end result, but I realize there is a wide spectrum of preferences on commit size and style.
Yes, that was my intention when making this project. I prefer the practice of making very small changes and committing frequently with opulent use of branches.
However, many of my peers and co-workers have a hard time following the small-commit workflow, so this project is really for them.
Being able to mark small (but significant) changes in your code as you code definitely helps reduce some ambiguity in commit messages.
Some feedback on that regard - if you could note line numbers or anything really w/ some of these it would probably help more than just messages. Eg "Concatenated strings in HelloWorld.js#12"
Comments
Presumably the impetus is that if you fix a bunch of small things in a single commit it might be easier to compile the list of small things you changed by noting them as comments as you fix them rather than trying to remember them after the fact when it comes time to write a commit log for that commit.
That said, philosophically I'd personally prefer to just commit the small features individually as a set of small commits, therefore you get a better git blame/praise experience with the end result, but I realize there is a wide spectrum of preferences on commit size and style.
Yes, that was my intention when making this project. I prefer the practice of making very small changes and committing frequently with opulent use of branches.
However, many of my peers and co-workers have a hard time following the small-commit workflow, so this project is really for them.
Being able to mark small (but significant) changes in your code as you code definitely helps reduce some ambiguity in commit messages.
Some feedback on that regard - if you could note line numbers or anything really w/ some of these it would probably help more than just messages. Eg "Concatenated strings in HelloWorld.js#12"
Having the source & line number makes these much more useful.
This is great feedback, thank you!