issue #31 - documentation