doc: update Python API to include streaming metadata option #1030
Description
Add generation metadata to Python API.
This is a worthwhile update, but one that would be documented well by a pointer into API reference rather than updates to conceptual or task content. Woe is me.
Originally posted by @mikemckiernan in #1011 (review)