(gh-pages) updated docs to match new behaviour