Two things

Comments on Comments

Check out this post by Andreas Klinger about comments, titled “Good comments explain WHY, not WHAT, and 3 more rules on writing good comments.”

While you wrote the code it was obvious to you - it will never be that obvious again - to no-one, including you.

So true. Even if you work primarily on your own, well written comments can save you from having to mental time travel later on. I’m definitely going to try to write better, less redundant comments from now on.

I found this post on, which has been described as Medium for developers. I would describe it as more personal, community-focused HN. But anyways, I just found out about this place the other day (on HN, I think…), and I really like it! The posts I see on here, while very informational, are also quite personable. Check it out!


comments powered by Disqus