Hook Docs: wp-admin/admin-post.php

[ericlewis]

admin_init, admin_post_{$_REQUESTaction?}, admin_post_nopriv_{$_REQUESTaction?}

[DrewAPicture]

Couple notes on 25361.diff​:

• s/REQUEST/$_REQUEST in the short description
• periods on the action hook variation descriptions

[rmccue]

Hmm. I'm not sure how we've handled cases like this previously, but would it be helpful to add an @alias PHPDoc tag to the parser for cases like this?

Something like:

/**
 * This is my action.
 *
 * @alias first_action This is one action that could be called.
 * @alias second_{$variable}_action This is another that could be called.
 */
do_action($action);

[DrewAPicture]

Replying to rmccue:

Hmm. I'm not sure how we've handled cases like this previously, but would it be helpful to add an @alias PHPDoc tag to the parser for cases like this?

Something like:

/**
 * This is my action.
 *
 * @alias first_action This is one action that could be called.
 * @alias second_{$variable}_action This is another that could be called.
 */
do_action($action);

I agree it could be useful. We can discuss it next week at the inline docs chat on Wednesday, 18:00 UTC. Or, if you'd like to pick a better time for you, we can meet up and talk about it in #wordpress-sfd or something. Interested?

[kpdesign]

Fix short description, add periods to end of hook descriptions.

[kpdesign]

25361.1.diff​ fixes items listed in @DrewAPicture's review in ​comment 1.

[DrewAPicture]

25361.1.diff​ looks good.

[DrewAPicture]

In 25589:

Inline documentation for hooks in wp-admin/admin-post.php.

Props ericlewis, kpdesign.
Fixes #25361.