[wp-trac] [WordPress Trac] #44453: PHPDoc comments do not contain all necessary @throws tags

WordPress Trac noreply at wordpress.org
Tue Jun 26 01:28:50 UTC 2018


#44453: PHPDoc comments do not contain all necessary @throws tags
------------------------------+-------------------------------------
 Reporter:  subrataemfluence  |       Owner:  (none)
     Type:  defect (bug)      |      Status:  new
 Priority:  normal            |   Milestone:  Future Release
Component:  General           |     Version:  trunk
 Severity:  normal            |  Resolution:
 Keywords:  needs-patch       |     Focuses:  docs, coding-standards
------------------------------+-------------------------------------
Changes (by netweb):

 * milestone:  Awaiting Review => Future Release


Comment:

 You are correct @subrataemfluence, there has not been much usage of
 `@throws` historically, it is also not documented in the
 [https://make.wordpress.org/core/handbook/best-practices/inline-
 documentation-standards/php/ handbook].

 A little more research and some documentation is probably required in
 order before landing this.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/44453#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list