Making the JSON Schema more modular would make it more readable. Each resource could be described in its own file or referencing existing schemas.