json-schema-org / website

JSON Schema website
https://json-schema.org
Other
57 stars 148 forks source link

[📝 Docs]: Create guide "How to validate data against a JSON schema" #954

Open valeriahhdez opened 2 weeks ago

valeriahhdez commented 2 weeks ago

What Docs changes are you proposing?

We need a guide to teach users how to validate data against a JSON schema that is tool agnostic. Any ideas on this topic are welcome!

Code of Conduct

rnd-debug commented 1 week ago

Hello, I am a simple user, but I was thinking : jwt.io does something similar in a user-friendly way. What if "teaching users how to validate a JSON against a schema in an agnostic way" consisted in providing the feature directly on the website ? In the case of jwt.io, for example, tokens are decoded and an error message (if needed) is directly displayed. Or do you have something different in mind for this issue? (Maybe a guide about how to actually implement the validation ?)

PS: jwt.io also have a way of displaying a list of libraries that implement tokens en/decoding for different languages and different "levels" of implementation (https://jwt.io/libraries), but this is a different topic.