json-schema-org/json-schema-spec is one of the open-source repositories TopGit tracks, currently at 5.2k stars, written primarily in JavaScript. The JSON Schema specification
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
JSON Schema is a vocabulary that allows you to validate, annotate, and
manipulate JSON documents.
This repository contains the sources for the work in progress of the next
set of JSON Schema IETF Internet Draft (I-D) documents. For the latest released
I-Ds, please see the
Specification page on the website.
Call for contributions and feedback
Reviews, comments and suggestions are most welcome!
Please read our guidelines for contributing.
Status
For the current status of issues and pull requests, please see the following
labels
Labels are assigned based on
Sensible GitHub Labels.
Authoring and Building
Specification
To build all the spec files to HTML from the Markdown sources, run npm run build -- specs. You can also build each individually with npm run build -- specs/filename.md (Example: npm run build -- specs/jsonschema-core.md). You
can also use wildcards to build multiple specs at the same time: npm run build -- specs/jsonschema-*.md. The HTML files will be available in the web folder.
The spec is built using Remark, a markdown engine with
good support for plugins and lots of existing plugins we can use. Remark also
has a language server and
a VSCode extension we can use to
get linting and link checking while developing the spec.
Plugins
The following is a not-necessarily-complete list of configured plugins and the
features they make available to you.
remark-lint -- Enforce markdown
style guide.
remark-validate-links --
Check for broken links.
remark-gfm -- Adds support for
GitHub Flavored Markdown specific markdown features such as autolink literals,
footnotes, strikethrough, tables, and tasklists.
remark-heading-id -- Adds
support for {#my-anchor} syntax to add an id to an element so it can be
referenced using URI fragment syntax.
remark-headings
-- A collection of enhancements for headings.
Adds hierarchical section numbers to headings.
Use the %appendix% prefix on headings that should be numbered as an
appendix.
Adds id anchors to headers that don't have one
Example: #section-2-13
Example: #appendix-a
Makes the heading a link utilizing its anchor
remark-reference-links
-- Adds new syntax for referencing a section of the spec using the section
number as the link text.
Example:
## Foo {#foo}
## Bar
This is covered in {{foo}} // --> Renders to "This is covered in [Section 2.3](#foo)"
Link text will use "Section" or "Appendix" as needed
remark-table-of-contents
-- Adds a table of contents in a section with a header called "Table of
Contents".
remark-code-titles
-- Add titles to code blocks
Example:
\`\`\`jsonschema "My Fun Title"
{ "type": "string" }
\`\`\`
The languages jsonschema and json have special styling
The title will be parsed as a JSON string, but you have to double escape
escaped characters. So, to get My "quoted" title, you would need to write
"My \\\\"quoted\\\\" title".
rehype-highlight --
Syntax highlighting.
rehype-highlight-code-lines
-- Adds line numbers to code blocks. Supports ranges.
remark-flexible-containers
-- Add a callout box using the following syntax. Supported container types are
warning, note, and experimental.
::: {type} {title}
{content}
:::
Internet-Drafts
To build components that are being maintained as IETF Internet-Drafts, run
npm run build-ietf.
Descriptions of the xml2rfc, I-D documents, and RFC processes:
Conformance tests for JSON Schema and its vocabularies may be found
in their own repository.
Tests for the meta-schema are included here. Run npm test to run the
meta-schema tests. To get a test coverage report, you can use npm run test:coverage. In addition to the CLI report, a detailed HTML report will be
generated in the coverage directory and can be viewed using something like
npx http-server coverage.
The website
The JSON Schema web site is at http://json-schema.org/
The source for the website is maintained in a separate repository.
Contributors
Code Contributors
This project exists thanks to all the people who contribute. [Contribute].
Financial Contributors
Become a financial contributor and help us sustain our community. [Contribute]
Sponsors
Here are our top sponsors. You could be next! [Become a sponsor]
Individuals
License
The contents of this repository are licensed under either the BSD
3-clause license or the Academic Free License v3.0.
How active is development on json-schema-org/json-schema-spec?
The most recent commit recorded on json-schema-org/json-schema-spec was 13 days ago, based on the GitHub push timestamp. The repository has 473 forks — one of the better signals of community interest.
How many stars does json-schema-org/json-schema-spec have?
json-schema-org/json-schema-spec has 5.2k GitHub stars — refresh the page for the live number, or check github.com/json-schema-org/json-schema-spec. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is json-schema-org/json-schema-spec open source?
TopGit's metadata for json-schema-org/json-schema-spec does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is json-schema-org/json-schema-spec?
json-schema-org/json-schema-spec (json-schema-org/json-schema-spec) is a JavaScript project on GitHub. From the project's own README: The JSON Schema specification
Where do I read more about json-schema-org/json-schema-spec?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/json-schema-org/json-schema-spec is the definitive source.
Read full README in the tab above.
Want a second opinion on json-schema-spec?
Ask an AI that can read this page — one click and you get its take on json-schema-spec.