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?

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