add notes about subspaces to top.md
Merge branch 'master' into gh-pages
rebuild HTMLs