add more docs, clean up documents

I've written two missing documentations on mixins.
Also wiped out some typos, and cleaned structure of docs for better readability of code.
Feel free to cherry-pick or merge.