[WIP] Fix api documentation

:construction: 

ref #4883

cc @DeepDiver1975 @karlitschek