document the interface. closes #7, #9