Skip to content

Commit

Permalink
Added the comments provided by Ben Hutton in PR #655
Browse files Browse the repository at this point in the history
  • Loading branch information
benjagm committed Jun 1, 2024
1 parent 52b92f0 commit 02ae82b
Showing 1 changed file with 4 additions and 5 deletions.
9 changes: 4 additions & 5 deletions pages/overview/what-is-jsonschema.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ JSON Schema is a declarative language for annotating and validating JSON instanc

When it comes to data exchange, JSON Schema stands out as a powerful standard for defining the structure and rules of JSON data. It uses a set of [keywords](https://json-schema.org/learn/glossary#keyword) to define the properties of your data.

While JSON Schema provides the language, validating a JSON [instance](https://json-schema.org/learn/glossary#instance) against a [schema](https://json-schema.org/learn/glossary#schema) requires a JSON Schema [validator](https://json-schema.org/implementations#tools). The JSON validator checks if the JSON documents conform to the schema.
While JSON Schema provides the language, validating a JSON [instance](https://json-schema.org/learn/glossary#instance) against a [schema](https://json-schema.org/learn/glossary#schema) requires a JSON Schema [validator](https://json-schema.org/implementations#validators). The JSON validator checks if the JSON documents conform to the schema.

JSON validators are open-source and commercial tools that implement the JSON Schema specification. They make it very easy to integrate JSON Schema into projects of any size.
JSON validators consist of both open-source and commercial tools that implement the JSON Schema specification. Such tooling enables easy integration of JSON Schema into projects of any size.

![How JSON Schema works](/img/json_schema.svg)

Expand All @@ -27,17 +27,16 @@ JSON Schema empowers developers in the following ways:
* **Data Validation:** JSON Schema ensures data validity through:
* Automated Testing: Validation enables automated testing, ensuring data consistently complies with specified rules and constraints.
* Improved Data Quality: By enforcing validation rules, JSON Schema aids in maintaining the quality of client-submitted data, reducing inconsistencies, errors, and potential security vulnerabilities.
* **Rich Tooling Ecosystem**: The JSON Schema community offers a wealth of tools and resources across various programming languages to help developers create, validate, and integrate schemas.
* **Rich Tooling Ecosystem**: The JSON Schema community offers a wealth of [tools](https://json-schema.org/tools) and resources across various programming languages to help developers create, validate, and integrate schemas.

### Benefits of JSON Schema for Organizations

JSON Schema empowers organizations by:

* **Simplifying Testing and Validation:**: JSON Schema reduces code complexity and development time by simplifying validation logic. It defines constraints for data structures, enabling the detection and prevention of errors, inconsistencies, and invalid data.

* **Facilitating Seamless Data Exchange:**: JSON Schema establishes a common language for data exchange, no matter the complexity of your project. It defines precise validation rules for your data structures to create a shared understanding and increase interoperability across different systems and platforms.
* **Enhancing Data Documentation**: JSON Schema enables the creation of clear and standardized representations of data. This improves understanding and collaboration among developers, stakeholders, and collaborators, enhancing organizational efficiency.
* **Access to a Vibrant Tooling Ecosystem**: JSON Schema is supported by a diverse array of languages, libraries, and frameworks with community-driven tools. This vibrant ecosystem enhances development productivity and provides resources for effective schema implementation and utilization.
* **Access to a Vibrant Tooling Ecosystem**: JSON Schema is supported by a diverse array of languages, libraries, and frameworks with community-driven [tools](https://json-schema.org/tools). This vibrant ecosystem enhances development productivity and provides resources for effective schema implementation and utilization.


## History of JSON Schema
Expand Down

0 comments on commit 02ae82b

Please sign in to comment.