Add crate-level documentation #16
Description
It would be nice to have a proper introduction and perhaps even an example in a crate-level doc comment (//!). These snippets additionally have the advantage of automatically being compiled during testing.