Add clarification to main page preamble to example code.
Remove confusing comment on performance in stage methodology.
Fix for Python3.
Change top markdown file to link to gh-page.