Re:Writing system software: code comments
by chrisweekly on Monday October 08, 2018 @10:49AM
(#18167957)
Comments can provide context by simply providing a link like "See Issue/ticket/card ID #123". That plus git blame, good commit messages, and feature branches named for the same ID, makes for a coherent whole -- without adding much overhead in terms of comment writing and maintenance.
So those things are both good also, but I consider them to be a fallback for cases where the code isn't commented like it should be.