Get documentation up to Rust API guidelines standard

[mantono]

See https://rust-lang.github.io/api-guidelines/documentation.html