Document public methods

[cptartur]

All public methods and structs should have rust docs strings ///. We should verify that docs.rs style docs generate correctly for our library.