We can have some generated human-friendly docs, perhaps in HTML, for people who don’t want to deal with the raw schema format directly

Things to consider

• Sub-types - we will want to include these automatically so that the reader doesn’t have to think too hard about it