Improve documentation

[luisschwab]

Fix up documentation in doc comments and README.

I think commonware's crates are a good reference for styling: https://docs.rs/commonware-storage/latest/commonware_storage/ordinal/index.html