issue #1, fix documentation