Function description is not present in some functions.

[priyankabehera155]

There is no description available in some of the functions. It is the standard rule to add descriptions in DocBlock.

File Path:- \src\wp-admin\custom-header.php
Functions:- customize_set_last_used, get_default_header_images, get_uploaded_header_images.

[tejas5989]

Hello,

I have added the description in two functions in the attached patch.

Thank You

[riddhiehta02]

Added the description for the function ( customize_set_last_used ).

[priyankabehera155]

Hi,

There lots of other file having functions which are not having function description. Below I have provided some files and its functions.

1. \wp-admin\includes\class-wp-comments-list-table.php - prepare_items, ajax_user_can, floated_admin_avatar, get_per_page, no_items, get_views, get_bulk_actions, extra_tablenav etc and lots more function in this page.

2. \wp-admin\includes\media.php - get_upload_iframe_src, get_compat_media_markup

Thank you

[alkesh7]

Replying to priyankabehera155:

This is a nice catch!

You found out really good things. WordPress must follow own coding standards.

Let's found out more and more functions for the same issue and create full list with one single reply.

Hi,

There lots of other file having functions which are not having function description. Below I have provided some files and its functions.

1. \wp-admin\includes\class-wp-comments-list-table.php - prepare_items, ajax_user_can, floated_admin_avatar, get_per_page, no_items, get_views, get_bulk_actions, extra_tablenav etc and lots more function in this page.

2. \wp-admin\includes\media.php - get_upload_iframe_src, get_compat_media_markup

Thank you

[jankimoradiya]

Hello,

I have added the description of the prepare_items() function in \wp-admin\includes\class-wp-comments-list-table.php file.

Thank You

[westonruter]

40231.4.diff​ contains both 40231.4.diff​ and 40231.2.patch​. I didn't include 40231.3.patch​ because the function description wasn't particularly descriptive and also it's not in the Customize component.

[westonruter]

Add since tags

[westonruter]

Add remaining since tags

[westonruter]

In 40788:

Docs: Add missing @since tags and phpdoc descriptions to the Custom_Image_Header class.

Amends [27497].
Props tejas5989, riddhiehta02, westonruter.
See #21785.
Fixes #40231.