initial stab at generated documentation for schema

Yo dawg! I heard you like documentation, so I added some documentation of how to generate documentation. 
this lines below use target/schema (without the s)
we should pick one