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 line is different from the curl above. we should pick one.