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