Comments inside the body of a function should apply to the state of the system at the point the comment “executes”. Here’s an example of poor comment placement: // Widget is already vibrating, so we update the waveform in place. // Else the waveform parameters will be set when we start vibrating. if (waveformParameters !
