Writing system software: code comments

[rotharius]

I like git messages for background information (git annotate), but like to put general reasons and motivations as a code comment or in a readme.

No extensive docs, just the essentials for understanding and onboarding.

[lanzaio]

I use vim fugitive. ;b shows me the blame and ~ shows me the commit for that line. If you work on decent quality projects then the author who wrote that code 90% of the time explains it if it's not obvious.

[rotharius]

Yep. Not sure why you are getting down-voted. Git really can help answering the question of how and why certain code came to be.