awesomemotive / wpforms-phpcs

PHP Coding Standards used by the WPForms team.
https://wpforms.com
GNU General Public License v2.0
11 stars 1 forks source link

Multiple @throws do not have the same formatting rules as @param #26

Open slaFFik opened 1 year ago

slaFFik commented 1 year ago

Consider this snippet:

 * @param string $email     The subscriber's current email address.
 * @param string $new_email The subscriber's new email address.
 *
 * @throws ResponseException Invalid response.
 * @throws RequiredArgumentMissingException Required argument is missing.

It looks inconsistent in the same phpdoc where we enforce special formatting for @param.

I think this looks better:

 * @param string $email     The subscriber's current email address.
 * @param string $new_email The subscriber's new email address.
 *
 * @throws ResponseException                Invalid response.
 * @throws RequiredArgumentMissingException Required argument is missing.