Let us do the heavy lifting, and avoid rolling your own tools or maintain custom scripts that glue together slow and buggy packages
Once your schemas grow, manually documenting them while making sure the documentation doesn't get out of sync is borderline impossible, and you might end up wasting time extending your static site generators with custom scripts that barely cover the subset of JSON Schema keywords you need.
Why waste your time developing a solution that should have existed all along?
Whatever version of JSON Schema you target, a segment of your users might be using a different version and likely cannot migrate to another one just for you. Manually upgrading and downgrading an ever growing collection of schemas to target every possible version of JSON Schema is unmaintainable at best.
What if you could automatically serve your schemas for every version of JSON Schema without additional effort?
GitHub Pages (and alternatives) will not serve your schemas using the right spec-compliant HTTP headers, you will not have control over HTTP caching for performance reasons, and will not be capable of automatically serving your schemas in a way that handles non-compliant IDE editors like Visual Studio Code.
Why care about all of these low-level details?
When was the last time you wrote your own testing framework for your programming language of choice instead of using an off-the-shelf one? Yet, most JSON Schema projects maintain custom scripts (if any!) to approximate the idea of a testing framework and other niceties to make sure their schemas do what was intended.
Wouldn't you rather get rid of all those ad-hoc scripts while getting a nicer developer experience?
Micro-second validation, formatting, linting, testing, bundling (inlining remote references), and more
Star on GitHubA growing collection of carefully crafted reusable schemas so you don't have to reinvent the wheel
A multi-language high-performance validation library built on top of our state-of-the-art schema compiler
A service for centrally managing, exploring, distributing, and governing your schemas
Please subscribe to our mailing list to express your support and be the first to know when our new projects are out.
Additionally, we are always seeking feedback, ideas, and suggestions to better serve the JSON Schema community. Don't hesitate in letting us know your thoughts in public using GitHub Discussions, or in private over e-mail.
Mastering JSON Schema is hard, and learning it by reading the specifications is not fun. That's why we are building Learn JSON Schema, the ultimate reference documentation site for JSON Schema. Plus it's open-source and you can contribute to it too!
www.learnjsonschema.com
If you require custom JSON Schema software, hands on help with your schemas, architecture design, private training, consulting, or anything in between, let's talk!
Ron Itelman: CEO at Intelligence.AI, co-author of Unifying Business, Data, and Code (O'Reilly), executive strategic consultant specializing in data strategy and product management
Juan Cruz Viotti: CTO at Intelligence.AI, co-author of Unifying Business, Data, and Code (O'Reilly), did award-winning research at the University of Oxford on data serialisation and data compression, and is part of the JSON Schema Technical Steering Committee
Reach out to hello@intelligence.ai to discuss how we can help