Hacker News Reader

Hacker News

Comment by jsjddbbwj | Hacker News Reader

Full thread

jsjddbbwj

Is there any code in WebKit that comes from khtml?

Is there any code in Source that comes from idtech 2?

View on HN

For a small personal project [0], it was 14 lines after three years continued in a company.

[0] http://beza1e1.tuxen.de/tipiwiki.html

This was a good read. Question from a naive programmer: the writer mentions 'cute comments' in the codebase, like

    // Assertion: Now we know the name of the current page

Is this style frowned upon? I've always thought it's a very clear way of communicating. There's a reason many maths papers are written like this. Do my co-workers think my comments are silly? :(

Comments is a mostly subjective topic. In this case, I have two arguments against the comment.

First, it just says what the three simple lines of code above did. Comments should rather focus on the "why" to provide information which the code cannot give.

Second, assertions should be code (or somehow machine readable).

Reply on news.ycombinator.com