BACKLOG-1581 -- Document interfaces mentioned in MT doc

What was done:
1) added \ changed comments based on DOC team feedback