Improve docs

More info on optional parameter and fix typo
Merge pull request #2901 from raulbrito/patch-1

Improve docs