please, check the modifications

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