Add clarifications and consistency changes in docs
Fix typo
Merge pull request #611 from chaplinjs/topics/doc-improvements

Add clarifications and consistency changes in docs