Add a lot of examples in docs

[Nadrieril]

As time progressed things have felt more and more obvious to me and new docs for the main struct/enums of Charon became more terse. There should be a lot more examples so that any Rust user can follow what a variant represents.