BACKLOG-1581 -- Document interfaces mentioned in MT doc

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

BACKLOG-1581 -- Document interfaces mentioned in MT doc