[mafuy]

It's same same issue we had 20 years ago with javadoc. Write what you want to do, not how you do it.

i++; // increment i (by 1)