Hacker News new | ask | show | jobs
by k2xl 1000 days ago
I typically write comments for "why" rather than "how". Or if I have to make what appears to be a weird hack or decision I put that too.

Another thing I really like to do is put github issues as comments if I am having to do some weird workaround in some API/library that I found from a github issue - i'll put the github issue URL so that way it is easy to see the latest update from that library later on to see if the workaround is no longer needed.