Hooks Docs: wp-admin/maint/repair.php

[ben.moody]

Patch contains comments for 'tables_to_repair' filter in wp-admin/maint/repair.php

[DrewAPicture]

Hi, thanks for the patch. Some notes on repair-path.diff​:

• The suggested language for filter short descriptions is to say, "Filter <this thing>". The goal is to focus on what is filterable and not why it's filterable :)
• So in this case, the what is which tables to to repair. And the default is an empty array, something that should be noted at the end of the parameter description (which is currently missing).

For more information on the style of hook docs we're looking for, check out the ​hooks section of the inline docs standards.

[ben.moody]

Replying to DrewAPicture:

Hi, thanks for the patch. Some notes on repair-path.diff​:

• The suggested language for filter short descriptions is to say, "Filter <this thing>". The goal is to focus on what is filterable and not why it's filterable :)
• So in this case, the what is which tables to to repair. And the default is an empty array, something that should be noted at the end of the parameter description (which is currently missing).

For more information on the style of hook docs we're looking for, check out the ​hooks section of the inline docs standards.

Uploaded corrections to patch file, please find new file - 25500-patch-v2.diff.

Thanks.

[kpdesign]

Second pass on 25500-patch-v2.diff

[DrewAPicture]

In 25725:

Inline documentation for hooks in wp-admin/maint/repair.php.

Props ben.moody, kpdesign.
Fixes #25500.