Improve documentation generation and updating

[gotbadger]

Currently examples exist both on here and on docs.bearer.com. If we ever bump the major version this also requires updating the docs in multiple places.

It would be good if we could keep this as the cental place for docs.