Docstrings need to updated

[bartlomieju]

I copy-pasted most of the docs from the Go implementation. These docstrings need to be reviewed and fixed to properly reference methods/structs in Rust implementation (including proper linking in docs.rs).