Skip to content

Commit f3cd264

Browse files
committed
Modified JTD compariosn. Removed sentence about unhelpful comparisons. Added referencing links.
1 parent 694b8ff commit f3cd264

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

docs/openjsf/application.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -74,14 +74,13 @@ JSON Schema is a domain-specific declarative language for validating and annotat
7474

7575
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.
7676

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.
7979

8080
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.
8181

8282
In comparison to Joi, a popular and well used Javascript validation library, JSON Schema offers a language agnostic and portable validation mechanism.
8383

84-
Many times we see comparisons made from one solution to JSON Schema. Often, they miss several key understandings.
8584
In summary, JSON Schema is language agnostic, declarative constraints based, interoperable, validation and annotation for JSON.
8685

8786
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
190189

191190
> What questions do you have? What questions might arise during your application?
192191
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.
193+
194+
[1]
195+
https://www.openapis.org/blog/2021/02/18/openapi-specification-3-1-released
196+
https://nordicapis.com/whats-new-in-openapi-3-1-0/

0 commit comments

Comments
 (0)