type generator: add descriptive comments into output

* Add description comments as top-level docstrings per defined struct
* `// type = event` for Event, etc (`type` field subtype selection)
* Add enum values as comment to fields that are enumerations
* Add comment where we use `interface{}` to represent a union of different types