Add comments to public methods

They're mostly YARD compatible, in case I decide to publish them
to rubydoc.info eventually.