Products · Product
JSON Schema
Raised as a usability problem by 6 people on Hacker News over 6 years (2018–2023), in 6 threads.
No issue was raised by at least 3 people in 3 threads this year.
No issue was raised by at least 3 people in 3 threads in the last 5 years.
Every issue, all time, most people first
Schemas force awkward JSON syntax that is hard to write and maintainUnreviewed
20182026- Schemas are horrible to write and maintain, forcing awkward JSON syntax2023-06-26
- Schema definition is ugly and developers could barely get it working2023-01-02
- Validation errors from complex schemas are hard to make meaningful for API users2018-02-18
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 6 complaints
- Schemas are horrible to write and maintain, forcing awkward JSON syntax2023-06-26
- Makes some things incredibly hard to express, and needs research into draft support across languages2023-05-31
- Can't figure out how to express polymorphic objects; the workaround is clumsy2023-03-22
- Schema definition is ugly and developers could barely get it working2023-01-02
- OneOf and allOf combinations behave counterintuitively, making schemas confusing to write and understand2019-04-14
- Validation errors from complex schemas are hard to make meaningful for API users2018-02-18