Add existing types to generated documentation

Also makes some docstring adjustments to make sure
the documentation looks readable (especially the
inline examples).

Part of blueprint top-level-types

Change-Id: Ic6f02ce92449ee23aa9be8645edd8f6f11ee18ab
Merge "Add existing types to generated documentation"