Resolve "remarks for API docs"

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

Merge request reports