remove examples and shift the majority of documentation to the docs site

The examples in the README were confusing because they lacked the necessary context to understand exactly what was happening. To resolve this I removed the examples and instead provided a link to the Docs website.