I support this idea. This is an especially good way for the community to document some obscure behavior. I created a quick mock on how the comments could be placed along existing examples.

I wanted to report that I have exactly the same issue on Steam version on Windows present in all available rendering settings. It happens randomly, often within ~1h of play. I installed Screeps on 2019-04-30.