[wp-trac] [WordPress Trac] #27129: Inline PHPDocs and Hook Docs: /wp-includes/widgets.php

[WordPress Trac]

#27129: Inline PHPDocs and Hook Docs: /wp-includes/widgets.php
--------------------------+------------------------------
 Reporter:  eliorivero    |       Owner:
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Widgets       |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  needs-patch   |     Focuses:  docs
--------------------------+------------------------------
Changes (by enej):

 * keywords:   => needs-patch


Comment:

 Hi eliorivero

 Welcome to trac, thanks for your contribution.

 Here is some feedback.
 - You should make sure you have periods to at the end of sentences
 - Change the version number are 3.0.0 instead of just 3.0.
 - A description at the end of the variables would be great as well.

 Checkout http://make.wordpress.org/core/handbook/inline-documentation-
 standards/php-documentation-standards/ for more info. I am learning too,
 check out #26821.

 Also @DrewAPicture might ask you to have 2 tickets. One for hook docs and
 the other for PHPDocs.

 Thanks for the patch, looking forward to the next one =).

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