Elaborate on types

fixes #119
Add file names as titles

fixes #119
Add examples for defaults and required properties

fixes #119