(gh-pages) updated docs to match new behaviour
(gh-pages) fixed default
Merge pull request #882 from cormacmccarthy/gh-pages

(gh-pages) updated docs to match new behaviour