You definitely need to remove the comment about a deliberate blank line when you remove the line.

Doesn't this cause the schema documentation to pack against the end of the documentation without a blank line to separate them?