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: docs/openjsf/application.md
+7-4Lines changed: 7 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -74,14 +74,13 @@ JSON Schema is a domain-specific declarative language for validating and annotat
74
74
75
75
It cannot be compared to OpenAPI. OpenAPI 3.1 now defers the schema definitions to the most recent release of JSON Schema[1]. Nor can it be compared to JSON-LD, which is designed for linked data. Nor can it be compared to schema.org which provides data semantics.
76
76
77
-
A possible comparison is to JSON Type Definition (RFC 8927), which is designed for code generation.
78
-
By way of comparison, JSON Schema has an extensive test suite, many more implementations and languages supported, and has vastly more use in the ecosystem.
77
+
JSON Type Definition (RFC 8927) is comparable but not an alternative, as it is designed only for code generation.
78
+
JSON Schema has many more implementations and languages supported, and has vastly more use in the ecosystem.
79
79
80
80
Protocol Buffers and Avro do not just specify a structure, but define the "over the wire" format and serialisation method. JSON Schema is designed for validation of JSON data rather than data definitions, enabling the definition of more complex validation constraints than would otherwise be possible.
81
81
82
82
In comparison to Joi, a popular and well used Javascript validation library, JSON Schema offers a language agnostic and portable validation mechanism.
83
83
84
-
Many times we see comparisons made from one solution to JSON Schema. Often, they miss several key understandings.
85
84
In summary, JSON Schema is language agnostic, declarative constraints based, interoperable, validation and annotation for JSON.
86
85
87
86
Beyond validation and annotation, we are actively supporting special interest groups to define new vocabularies and dialects to add additional semantics and mechanisms to JSON Schema in order to support other use cases, such as UI generation, code generation, and databases.
@@ -190,4 +189,8 @@ We do and will need assistance in terms of
190
189
191
190
> What questions do you have? What questions might arise during your application?
192
191
193
-
I have already had several calls with various people at the OpenJSF, and do not have any outstanding questions.
192
+
I have already had several calls with various people at the OpenJSF, and do not have any outstanding questions.
0 commit comments