[wp-trac] [WordPress Trac] #53119: Tests: introduce naming conventions for data providers and use named test cases

[WordPress Trac]

#53119: Tests: introduce naming conventions for data providers and use named test
cases
------------------------------+------------------------------
 Reporter:  jrf               |       Owner:  (none)
     Type:  task (blessed)    |      Status:  new
 Priority:  normal            |   Milestone:  Awaiting Review
Component:  Build/Test Tools  |     Version:
 Severity:  normal            |  Resolution:
 Keywords:                    |     Focuses:  docs
------------------------------+------------------------------

Comment (by jrf):

 >   5. for tests that use a data provider, always include @param tags in
 the test's DocBlock.
 >
 > I'm not sure how many there are, but I know there are existing tests
 which use providers that do not do that (and I may have been responsible
 for a few of those).

 @pbiron Agreed. That's a given and is actually part of the WordPress
 Coding Standards, though Core doesn't run the `WordPress-Docs` standard
 yet over the code base. Can't say I blame them as the `Docs` standard
 still needs a lot of improving.

 For the time being, we could very selectively just enable that specific
 error code (undocumented function parameters) for the `Tests` directory to
 safeguard this.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/53119#comment:13>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform