BACKLOG-1581 -- Document interfaces mentioned in MT doc

What was done:
1) changed comments based on Doc team feedback
Merge pull request #37 from kolinus/BACKLOG-1581

BACKLOG-1581 -- Document interfaces mentioned in MT doc