Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

JavaScript Object Notation (JSON) is an open standard data interchange format that uses human-readable text to exchange data in name-value pairs.

...

  • Property - a name/value pair within a JSON object

  • Property Name - the name portion of a name/value pair

  • Property Value - the value portion of a name/value pair

General Guidelines

Do not use Envelope Style (or Enveloping) in which the top level object is a named property. Rather, follow the industry practice of rendering the top level object's child properties directly with no named property at the beginning.

No comments - don't use comments in JSON / JsonSchema. JsonSchema provides specific support for examples and descriptions. JSON files free from comments are a conventional feature of this lightweight format.

...

Enumerated types: Enum values should be represented as strings.Always make sure that you are referencing the property definition. - Move to Schema Building Procedures document

Property Values Data Types

...