Resolve "remarks about API docs"

Merged Piotr Gawron requested to merge 1775-api-docs-issues into devel_16.2.x

Merge request reports