Issue 116 - Document the API

--HG--
extra : amend_source : 75a9ff7ff724089fa0bed1f1a20e31c7c9984ac0