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 Slide

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

    View Slide

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

    View 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 Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View 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 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 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 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 Slide

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

    View 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 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 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 Slide