api documentation improvements

Signed-off-by: Christian Lüthold <biocodr@gmail.com>