Add documentation for new public methods
Clarify comments a bit more