News for hackers. Stuff that matters.
Re:Using JSON Schema to Document, Test, and Debug APIs by ivanhoe on Monday April 15, 2019 @08:21AM (#19664765)
Well, JSON Scheme has "title", "description", and "examples" keywords that are meant to be used for additional info, so not having comments is not really that big deal as with plain JSON. For XML Schema comments are essential as it's super verbose and hard to read. Of course, if you use it a lot you'll with time train your brain to scan through the forrest of XML tags without effort, just like in 90s we were able to easily make sense of multi-level nested tables - but to untrained eyes it's still a mess of tags with million options and it's the main reason why XML lost the popularity - too much noise and verbosity.
Re:Using JSON Schema to Document, Test, and Debug APIs by handrews on Tuesday April 16, 2019 @01:30PM (#19675543)
JSON Schema has "$comment" as of draft-06 or -07 (I forget, which is funny b/c I was the one who added it).