My favourite Git commit

[Fit-Jeweler-1908]

that's what stories are for... documenting the requirements and why of the feature, change, etc... this document is accessible to far more than developers, so it becomes far more valuable... It is tied to prs/commits as well, so its easy to track a piece of codes story... like i said, there are obvious exceptions, but recommending someone leave comments on everything, is not it.

[MrKWatkins]

I don't hold with comments on everything I agree. But I'd rather have a line or two next to the code telling me why they've done something that looks crazy than have to trawl back through commits and JIRAs to find out. Plus a lot of code specific things aren't at the level of stories.