schemas: add to docs
schemas: add sub typing hierarchy diagram