Skip to content

Commit 75cb66a

Browse files
committed
Adding feedback to improve the messaging and illustration
1 parent 233f41c commit 75cb66a

File tree

3 files changed

+4
-5
lines changed

3 files changed

+4
-5
lines changed

pages/overview/what-is-jsonschema.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
section: docs
33
title: What is JSON Schema?
44
---
5-
JSON Schema is a declarative language for annotating and validating JSON documents' structure, constraints, and data types. It provides a way to standardize and define expectations for JSON data.
5+
JSON Schema is a declarative language for annotating and validating JSON instances' structure, constraints, and data types. It provides a way to standardize and define expectations for JSON data.
66
<br/>
77

88

@@ -14,13 +14,13 @@ While JSON Schema provides the language, validating a JSON [instance](https://js
1414

1515
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.
1616

17-
![How JSON Schema works](/img/json_schema.svg)
17+
![How JSON Schema works](/img/json_schema.png)
1818

1919
## Benefits of JSON Schema for Developers
2020

2121
JSON Schema empowers developers in the following ways:
2222

23-
* **Structured Data Description**: JSON Schema allows developers to describe the structure, constraints, and data types of existing JSON formats.
23+
* **Structured Data Description**: JSON Schema empower developers to use JSON to describe the structure, constraints, and data types of existing JSON data.
2424
* **Rule Definition and Enforcement**: By adhering to JSON schema constraints, it becomes easier to exchange structured data between applications as it maintains a consistent pattern.
2525
* **Produce clear documentation**: JSON Schema supports the creation of machine and human readable documentation.
2626
* **Extensibility:** JSON Schema offers high adaptability to developers' needs. Custom keywords, formats, and validation rules can be created to tailor schemas according to specific requirements.
@@ -45,7 +45,7 @@ JSON Schema empowers organizations by:
4545

4646
JSON Schema dates back to the [first JSON Schema proposal](https://web.archive.org/web/20071026185150/http://json.com/json-schema-proposal/) submitted by Kris Zyp to [json.com](http://json.com) on October 2nd, 2007.
4747

48-
The current version of JSON Schema is [2020-12](https://json-schema.org/draft/2020-12/release-notes), which represents the latest advancements and has expanded capabilities compared with the previous versions, `draft-04`, `draft-06`, and `draft-07`.
48+
The newest version of JSON Schema is [2020-12](https://json-schema.org/draft/2020-12/release-notes), which represents the latest advancements and has expanded capabilities compared with the previous versions, `draft-04`, `draft-06`, and `draft-07`.
4949

5050
We recommend using the newest version of JSON Schema and taking advantage of its benefits.
5151

public/img/json_schema.png

49.9 KB
Loading

public/img/json_schema.svg

-1
This file was deleted.

0 commit comments

Comments
 (0)