KnowledgeHub
Questions
Tags
Users
Search
Alex Rivera
|
Logout
Edit Question
Title
Body
What is the best way to describe JSON data in a spec? In the past I've used examples with 'wordy' descriptions, but it feels imprecise. There seems to be a nascent JSON schema standard, but it doesn't look like a hugely active project. Any other ways? ( Update ) After thinking about this for several days I like bmargulies suggestion around using a conversion convention. Since the JSON documents in this case our coming out of .NET web services I am going to simply document the schema with C# class syntax. This may not be totally rigourous, but everyone involved will understand it and coupled with the examples will get the message across as quickly as possible.
Tags (comma-separated)
Save Edits
Cancel