Fix haddock module header on `Web.HZulip`

I'd copy and pasted it from `butter-core`. Oops?
Update the README to reflect the new interface

This updates the repository's example and adds a note on the
outdatedness of the currently implemented bots.
Improve and fix-up the haddock documentation

Fixes broken links and removes unnecessary notes.
Bump version to 1.0.0.0