improved API docs

Merged Piotr Gawron requested to merge 1807-add-gene-api-docs into devel_16.2.x

Merge request reports