Added 'signs you're veering from good API design'.
Fix typos, spelling, phrasing etc.
Merge branch 'simple-rest-rules' into gh-pages