Improve docs

More info on optional parameter and fix typo