Add clarifications and consistency changes in docs

I went through all of the docs, trying to clarify things, fix typos, improve consistency and increase legibility within their new roaming ground at `docs.chaplinjs.org`.

This change should also take care of #609 and  #592.