Docblock improvements for 4.8

[johnbillion]

Follow-up to #37770.

[johnbillion]

In 39530:

Taxonomy: Correct the type for the first parameter of the the_category filter.

See #39130

[keesiemeijer]

improvements for /wp-includes/functions.php

[keesiemeijer]

improvements for /wp-includes/general-template.php

[keesiemeijer]

improvements for /wp-includes/kses.php

[keesiemeijer]

improvements for /wp-includes/link-template.php

[keesiemeijer]

improvements for /wp-includes/media-template.php

[keesiemeijer]

improvements for /wp-includes/media.php

[keesiemeijer]

improvements for /wp-includes/ms-functions.php

[keesiemeijer]

improvements for /wp-includes/nav-menu.php

[keesiemeijer]

improvements for /wp-includes/pluggable.php

[keesiemeijer]

improvements for /wp-includes/rest-api.php

[keesiemeijer]

improvements for /wp-includes/taxonomy.php

[keesiemeijer]

improvements for /wp-includes/theme.php

[keesiemeijer]

improvements for /wp-includes/vars.php

[keesiemeijer]

Just to clarify some of the patches.

In 39130.5.patch​ the DocBlock is not found by the parser because it's a comment. This has the consequence that it's imported as a duplicate filter (without the parameters).
​https://developer.wordpress.org/reference/hooks/image_size_names_choose-4/

In 39130.7.patch​ the @since parameter is only picked up by the parser if there's only one space before it. Now it's displayed in the description section instead of the change log section.
​https://developer.wordpress.org/reference/functions/wp_update_network_counts/

[johnbillion]

In 39638:

Docs: Add and correct @since docs for a variety of functions and methods.

Props keesiemeijer, chris_dev
Fixes #39343, #39357, #39344
See #39130

[johnbillion]

In 39639:

Docs: Misc corrections and additions to inline documentation.

See #39130
Props keesiemeijer

[keesiemeijer]

These hooks should be documented:

• load-page-new.php in /wp-admin/admin.php
• load-page.php in /wp-admin/admin.php
• load-categories.php in /wp-admin/admin.php
• load-edit-link-categories.php in /wp-admin/admin.php
• load-edit-tags.php in /wp-admin/admin.php
• header_video_settings in /wp-includes/theme.php

For the header_video_settings filter there's this patch.

The actions in /wp-admin/admin.php are deprecated but should still be documented because of ​this issue with the parser.

In the ​PHP Documentation Standards handbook we should make it more clear that DocBlocks start with a double asterisk (/**) and should only be used for ​these elements. For all other inline documentation ​multi-line or ​single-line comments should be used. This is an example of wrong DocBlock usage that the parser picks up as a DocBlock and could potentially assign to a hook.

[SergeyBiryukov]

In 40043:

Docs: Clarify that get_the_category_list() and the_category() display links as an unordered list by default.

See #39130.

[SergeyBiryukov]

In 40046:

Docs: Use third-person singular verb for wp_get_custom_css filter description.

See #39130.

[SergeyBiryukov]

In 40047:

Docs: Use third-person singular verb for rest_avatar_sizes filter description.

See #39130.

[DrewAPicture]

In 40298:

Docs: Add a missing return description for get_post_taxonomies().

h/t deeptiboddapati.
See #39130.