You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
# A New JSON Schema
2
-
A JSON schema is crucial for making communication, interoperability, validation, testing, documentation, and specification seamless. All of this combined contributes to better maintenance and evolution of web services.
2
+
JSON, short for JavaScript Object Notation, is one of the most widely used data exchange formats that are both user-friendly and machine-readable. A JSON Schema is crucial for making communication, interoperability, validation, testing, documentation, and specification seamless. All of this combined contributes to better maintenance and evolution of data-driven applications and systems.
3
3
4
4
## Design Goals
5
-
The traditional standard JSON schema rigorously follows the conventional JSON structure, which unfortunately comes at the expense of simplicity, conciseness, and readability. Our goal is to develop a new JSON schema that promotes these essential aspects that were previously missing.
5
+
The traditional standard JSON Schema rigorously follows the conventional JSON structure, which unfortunately comes at the expense of simplicity, conciseness, and readability. Our goal is to develop a new JSON Schema that promotes these essential aspects that were previously missing.
6
6
7
7
This new schema is simple, lucid, easy to grasp, and doesn't require much prior knowledge to understand it. It also offers a shallow learning curve for both reading and writing. Furthermore, its inherent extensibility simplifies the process of integrating new constraints and functionalities to meet the diverse requirements of modern web services.
8
8
@@ -35,7 +35,7 @@ Let's explore an example of our schema for a typical JSON API response containin
35
35
}
36
36
}
37
37
```
38
-
In the above example, two types of constraint or rule descriptors are used: constraint functions (also known as validation functions, such as `@range(1, 10000)`) and constraint data types (also known as validation data types, such as `#integer`). All constraint functions begin with the `@` symbol, while all constraint data types start with `#`. C-style comments are also permitted in the schema. Please note that `address` can be `null` (eg. an optional input for users) and if it is `null` then no constraints of `address` are applicable. The following JSON is one of the examples which can successfully validate against the above schema. To start your journey with the JSON validation library, please consult the documentation available <ahref="/articles/intro.html">here</a>.
38
+
In the above example, two types of constraint or rule descriptors are used: constraint functions (also known as validation functions, such as `@range(1, 10000)`) and constraint data types (also known as validation data types, such as `#integer`). All constraint functions begin with the `@` symbol, while all constraint data types start with `#`. C-style comments are also permitted in the schema. Please note that `address` can be `null` (eg. an optional input for users) and if it is `null` then no constraints of `address` are applicable. The following JSON is one of the examples which can successfully validate against the above schema. To start your journey with the JSON validation library, please consult the documentation available <ahref="https://relogiclabs.github.io/JsonSchema-DotNet/articles/intro.html">here</a>.
39
39
```json
40
40
{
41
41
"user": {
@@ -59,7 +59,7 @@ In the above example, two types of constraint or rule descriptors are used: cons
59
59
}
60
60
```
61
61
## Extended Example
62
-
The next example represents an expanded version of the previous one, which brings more complexity. To effectively construct such schemas with multiple layers of nested structures, it's beneficial to have a fundamental understanding of this schema format. While the syntax may seem difficult at first, it becomes straightforward once you have a basic understanding of it. For more detailed information, reference documentation is available <ahref="/api/index.html">here</a>.
62
+
The next example represents an expanded version of the previous one, which brings more complexity. To effectively construct such schemas with multiple layers of nested structures, it's beneficial to have a fundamental understanding of this schema format. While the syntax may seem difficult at first, it becomes straightforward once you have a basic understanding of it. For more detailed information, reference documentation is available <ahref="https://relogiclabs.github.io/JsonSchema-DotNet/api/index.html">here</a>.
63
63
```cpp
64
64
%title: "Extended User Profile Dashboard API Response"
65
65
%version: 2.0.0
@@ -214,4 +214,4 @@ The subsequent JSON sample is an illustrative example that successfully validate
214
214
}
215
215
}
216
216
```
217
-
For more information about the schema syntax format and library functionalities, please refer to the reference documentation <ahref="/api/index.html">here</a>.
217
+
For more information about the schema syntax format and library functionalities, please refer to the reference documentation <ahref="https://relogiclabs.github.io/JsonSchema-DotNet/api/index.html">here</a>.
0 commit comments