PHP Config - Suites

[loic425]

With the current state of Behat/Behat#1539

I think we need to create a specific branch "3.17".

Overview here https://behat--179.org.readthedocs.build/en/179/user_guide/configuration/suites.html#suite-paths

The filters implementation is still on PR review.

[carlos-granados]

@loic425 what is the plan, to show both yaml and php configuration? Not sure if we should just show php configuration and then mention somewhere that you can also use yaml with some examples, the same way that I am doing with attributes and annotations in this PR #178

[stof]

I don't think we want to maintain separate versions of the documentation for each minor version (especially given that older minor versions don't receive updates according to our versioning policy). It is unfortunate that the documentation branch is named 3.0 and not 3.x but renaming it would break all links (unless we configure RTD to redirect that version)

[loic425]

@acoulton I've updated this PR with last changes.

[acoulton]

This is looking good to me.

I agree with the others that we should only have one branch per major-version-series in the docs, and that we should just migrate the docs examples from yaml to PHP rather than showing both.

I'd suggest we add one single page for the YAML config that just shows a single example of a complete YAML file with all available options, perhaps with comments to mark which PHP config objects they equate to?

[acoulton]

Looks great, thanks @loic425 - I've just rebased it to pick up an unrelated linting issue that was fixed in 3.0 since you opened this.

[carlos-granados]

Thanks @loic425