[Issue #372][WIP] fixed docs comments