Skip to content

Comment on My Case Against Code Commentsparent

Comments

Exactly. Code is for expressing how things are done.* Comments are for expressing why.

* Or if you're not into the whole imperative languages bit, what things are done.

Totally OT: How are you managing to use an asterisk as a footnote indicator and not ending up with the two asterisks invisible and the text in between in italic? I've seen this before and I've tried to replicate it and I can't do it. :-/

An asterisk followed by whitespace doesn't begin italics, so you get * word * rather than word.

Oh. Thank you!

That says what I wanted in less words. I like it. You probably have good comments.

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.