Improve doc

Documentation for the changes of Behat 3 upgrade
Typo here, should be `documented`, a reference/link to existing sentences would be helpful.