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.