First pass on the docstring rewrite

(see the example auto-embed in the README)