The configuration page
https://docs.behat.org/en/latest/user_guide/configuration.html
Should be updated to use the new PHP config instead of the old yaml config.
We still want to keep some information about the yaml config, so apart from updating this page to use the PHP config we should add a new section that describes the possibility to use yaml, probably with a full configuration example and some text explaining that this option will probably be deprecated in the future (See https://docs.behat.org/en/latest/user_guide/annotations.html as an example of the text that we used for a similar option of using annotations instead of attributes)
The configuration page
https://docs.behat.org/en/latest/user_guide/configuration.html
Should be updated to use the new PHP config instead of the old yaml config.
We still want to keep some information about the yaml config, so apart from updating this page to use the PHP config we should add a new section that describes the possibility to use yaml, probably with a full configuration example and some text explaining that this option will probably be deprecated in the future (See https://docs.behat.org/en/latest/user_guide/annotations.html as an example of the text that we used for a similar option of using annotations instead of attributes)