Define a standard for documenting data providers in PHPUnit-based tests

In PHPUnit 11 we'll need to use the #[DataProvider] attribute. Not sure we need to enforce any particular naming convention if we have this.

In 📌 Rename mis-named data providers discovered in #3421418 Postponed , we also noticed a few data providers that were named testSomethingSomethingProvider(), rather than the more common providerTestSomethingSomething(). It might be worth having an explicit standard about the naming, especially since the pattern of those three methods made it look like they were test methods themselves rather than data providers. (I don't know if PHPUnit actually tries to run them, but it is confusing.) Added to the IS.

Adding the new template

As I mentioned on the other issue, I also am not sure if lumping naming with documentation expectations is correct. It should possibly be separate issues.

The issue title "Discuss the standards for data providers in PHPUnit-based tests" to me suggests a holistic approach. Happy for someone else to split it in to multiple tickets, but it makes sense to me to discuss it as a whole in this issue and split off once concrete decisions are made.

Moved the naming work to #3456134: Define a standard for naming data providers in PHPUnit-based tests →