issue #9: add documentation