Validated example support #349
Description
Right now we put examples into the docs, and sometimes the YAML. We should find a unified way of doing this, and consider doing so in a way such that examples are validated against the JSON Schema (and throw build errors if invalid or deprecated).