Question

I highly like to comment my code for my own reference, and also since i keep (most) of my projects open-source.

I current comment as if I’m the narrator:

// Check if y is higher than x.

Should i comment as if im talking to a group of people?:

// Now we check if y is higher than x.

This isn’t much of a question, i just want to get people’s commenting preferences

Answer 1

I really don’t care how the comments are phrased, as long as they are commenting the right thing.

I don’t need you to tell me that you’re checking if x is greater than y, I need you to tell me why you’re doing it.

“Check if we need to calculate the delay time required.” is much better than “Check if x is greater than y”.