updated docs with the changes from Jimmy, see pull request from April 17, 2014