*added* api documentation (closes #19)