Hi Nicholas,
Thank you for the proposal. The way I see it is that JSON schema can be
very developer unfriendly to read, therefore I would not rely on it for
this purpose. Adding $refs as well could start making it more
complicated for this purpose. It's helpful for structuring and
maintaining the files though.
Normally, a schema is meant for validation purposes. And docs should
provide the developer with the right information.
Nonetheless, I am getting started in replacing Warlock with Pydantic.
And basing the Python classes on Pydantic models. Unfortunately, this
will nullify this work altogether, as Pydantic provides an automatic
facility for generating the JSON schema, thus removing the need for
manual maintenance.
Best,
Luca
