Keep docs and Readme examples in sync

[cehbrecht]

As mentioned in issue #649 the examples in readme and docs were not in sync.

• We could add a link to the examples in docs.
• We could also provide examples as notebooks with nbsphinx

In nbspinx example in birdy: https://birdy.readthedocs.io/en/latest/examples.html