Update API Schema/Type Documentation

Currently the JSON schemas for the response resources (see github) are outdated and they also lack detailed descriptions about the type and purpose of each field.

When can we expect updates to the documentation? Better yet, are there any plans to provide schema and type metadata for these resource objects as endpoints in the API?