Since one of the main purposes of schemas are to encode and communicate metadata, several colleges and I believe that the JSON schema's description field should be an array of strings instead of a single string.
This would greatly improve the human readability of the schemas themselves, by allowing multiple lines in many text editors that are NOT word wrapping by default.
"properties": {
"post-office-box": {
"type": "string",
"description": ["This is often a box at the post office",
"that is paid for on a monthly or yearly basis. ",
"If you use a PO Box as your main address, google will NOT",
"let you register your S-Corp on my google business, wtf,"]
},
"extended-address": {
"type": "string",
"description ": "I can NOT read really long lines in JSON schemas that have to be on a single line in my json text editors and it's driving me NUTs!"
},