[wp-trac] [WordPress Trac] #63892: Fix grammar and PHPDoc inconsistencies in functions.php

WordPress Trac noreply at wordpress.org
Thu Aug 28 06:59:43 UTC 2025


#63892: Fix grammar and PHPDoc inconsistencies in functions.php
--------------------------+-----------------------------
 Reporter:  prab18hat     |      Owner:  (none)
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  General       |    Version:
 Severity:  normal        |   Keywords:  needs-docs
  Focuses:                |
--------------------------+-----------------------------
 Summary of Changes:

 Standardized PHPDoc for is_new_day():

 Updated the @return type from int to bool for clarity and modern PHPDoc
 standards.

 Grammar and Docblock Improvements in functions.php:

 xmlrpc_getpostcategory(): Clarified the return type and simplified awkward
 phrasing for readability.

 get_weekstartend(): Improved the @param description for $start_of_week to
 clearly state “Default is an empty string.”

 build_query(): Corrected grammar by adding the missing article and
 removing an unnecessary comma.

 Old: Builds URL query based on an associative and, or indexed array.

 New: Builds a URL query based on an associative or indexed array.

 get_status_header_desc(): Updated return description to: “Status
 description if found, or an empty string otherwise.” for better clarity.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63892>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list