Adding docs about Messages feature

... and some page refactor to organize text flow.

Closes #744. 
same for other code comments