Upgrade to Pro — share decks privately, control downloads, hide ads and more …

The State of JSON Schema

The State of JSON Schema

Recording: https://www.youtube.com/watch?v=im_uu_9p7Jo

What does JSON Schema look like in 2021, and where will it go in the future?

Ben Hutton

July 06, 2021
Tweet

More Decks by Ben Hutton

Other Decks in Technology

Transcript

  1. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    The State of
    JSON Schema
    🧔 Ben Hutton
    💻 @relequestual on the internet
    👨🚀 JSON Schema Specification Lead @ Postman!
    👨💻 benhutton.me
    🙌 opencollective.com/json-schema
    🎤 apidays Interface 2021

    View full-size slide

  2. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    JSON Schema?

    View full-size slide

  3. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    JSON Schema!

    View full-size slide

  4. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Specify it,
    and they will implement?
    It wasn't great, but it was good enough!

    View full-size slide

  5. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    How did we get here?

    View full-size slide

  6. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Drafts?

    View full-size slide

  7. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Focus on validation
    Acknowledging
    other use cases

    View full-size slide

  8. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Postman Open Technologies
    🎉 Partnering with JSON Schema 🎉

    View full-size slide

  9. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Elevating JSON Schema

    View full-size slide

  10. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Better Serving the Community
    🤔
    - Limited Slack History (🤙?)
    - Who "owns" JSON Schema?
    - Unknown decisions
    - Current documentation?
    - How to use Slack?
    - Other use cases?
    - Is JSON Schema done yet?
    💡
    - GitHub Discussions
    - Joining the OpenJS Foundation?
    - Architecture Decision Records
    - Updating learning resources! OAI
    - Greetbot enabled!
    - Vocabulary SIGs (Special Interest Groups)
    - ...😅 soon?

    View full-size slide

  11. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Is JSON Schema "done" yet?
    We need your feedback!
    - Feedback on Dialects and Vocabularies to make pragmatic changes if required.
    Discussions started for CodeGen and Database by vendors.
    - Another look at `format`
    - Did we get dynamic references right?
    - Output format
    Draft 2020-12 used by OpenAPI 3.1.
    Processing model is "done" or mostly done. Vocabularies may be simplified.
    Should we self publish or publish through a standards org?

    View full-size slide

  12. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Working on a
    "patch" release
    https://github.com/json-schema-org/json-schema-
    spec/milestone/9

    View full-size slide

  13. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Beyond the spec?
    - Tests format revamp
    - Linter
    - Educational resources
    - Audit of Implementations
    - Guidelines and best practices
    - Case Studies

    View full-size slide

  14. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Where do I go?

    View full-size slide

  15. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Where to go
    Basics: json-schema.org/learn
    More info: json-schema.org/understanding-json-schema
    Playgrounds:
    jsonschema.dev (draft-07 only for now)
    json-schema.hyperjump.io (04 – 2020-12)
    Help: stackoverflow.com (and tag with `jsonschema`)
    Community:json-schema.org/slack
    Twitter: @jsonschema
    Elevating the community: github.com/json-schema-org/community

    View full-size slide

  16. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    Thank you all
    • Previous and current team
    • Contributors and community
    • Implementation developers
    Pictures thanks to @bit_loom

    View full-size slide

  17. apidays Interface 2021 – Ben Hutton @relequestual / benhutton.me – JSON Schema / Postman
    The State of JSON Schema
    Thank you sponsors!
    AsyncAPI Initiative
    🧔 Ben Hutton
    💻 @relequestual on the internet
    👨🚀 JSON Schema Specification Lead @ Postman!
    👨💻 benhutton.me
    🙌 opencollective.com/json-schema
    🎤 apidays Interface 2021
    Retool
    Stoplight
    apideck

    View full-size slide