Comenting code
@Vordimous @linuxgal when I see this sort of thing when reviewing PRs, I write words to the effect of "tell me WHY it's doing that, not WHAT it's doing". The "what" is usually obvious from the code and thus not worthy of comment. The "why" will enlighten your colleagues (and future you).
Russ O @cupoftea.social Linux/sysadmin/infrastructure geek, Cloud Architect. Dad, cyclist, DIYer, renewable energy enthusiast. Left/liberal/green, anti-Brexit, atheist. Yorkshireman, beard. Scouts trustee. Born 335ppm.
Posts 0
Comments 1