Documention - `Result` errors

[samuelznewton]

There are several functions in this crate that return a Result, but do not document the errors that can be returned and why. Could you please add documentation about errors?