The spec says the following regarding the $comment keyword:

The value of this keyword MAY be used in debug or error output which is intended for developers making use of schemas.

I've noticed this before and keep forgetting to bring it up. I think this a bad idea. Comments should not be used for anything by the implementations. I'd like to remove this and strengthen the language that implementations MUST NOT use comments for anything. What do you think?