minor adjustments por splitting and adding notes
Merge branch 'gh-pages'