improve doc

some random improvements and additions i stumbled over while updating our project.
given that people are not familiar with this syntax, it could be good to mention that aliases are defined for a given file only (we had someone asking about supporting YAML aliases between the different imported config files in Behat yesterday)