scummvm/scummvm — comment on commit 9b838239ebed10e75b3806fd7c3a97922d2c0aa5
File: engines/sci/sound/music.cpp line 393
By OmerMor:

that's one option. another is to write self documenting code, which in this example would mean named constants that would make the comments unnecessary (http://en.wikipedia.org/wiki/Self-documenting). However it's subjective, there's no single truth here, and since I'm not a dev in this project, I'm not at liberty to judge.