issue #5 - more documentation