update docs to provide partitioning advice and links
Merge branch 'master' of github.com:amahi/docs