News for hackers. Stuff that matters.
Re:Using JSON Schema to Document, Test, and Debug APIs by pjmlp on Sunday April 14, 2019 @04:01PM (#19661358)
And now the circle is complete, with the difference that XML Schema allows for proper comments.
Re:Using JSON Schema to Document, Test, and Debug APIs by Pxtl on Sunday April 14, 2019 @04:27PM (#19661497)
I never saw XML schema as a bad idea, just overdesigned and verbose, same as all things XML.
Re:Using JSON Schema to Document, Test, and Debug APIs by pjmlp on Sunday April 14, 2019 @05:03PM (#19661704)
I happen to think otherwise regarding XML, and rather enjoy using all high level tooling for XML processing.
Re:Using JSON Schema to Document, Test, and Debug APIs by edejong on Monday April 15, 2019 @01:28AM (#19663287)
As opposed to underspecified, and ill thought out?

To me it seems the XML era had better engineers making the standards.

Re:Using JSON Schema to Document, Test, and Debug APIs by FigmentEngine on Sunday April 14, 2019 @05:33PM (#19661835)
relax ng?
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).