added observations and fixed some typos
Merge branch 'gh-pages'