[wp-trac] [WordPress Trac] #28680: Convert docs for default wp_link_pages() arguments to a hash notation

WordPress Trac noreply at wordpress.org
Sun Jun 29 17:41:17 UTC 2014


#28680: Convert docs for default wp_link_pages() arguments to a hash notation
-------------------------------+----------------------------------------
 Reporter:  DrewAPicture       |      Owner:
     Type:  defect (bug)       |     Status:  new
 Priority:  normal             |  Milestone:  Awaiting Review
Component:  Posts, Post Types  |    Version:
 Severity:  normal             |   Keywords:  needs-patch good-first-bug
  Focuses:  docs               |
-------------------------------+----------------------------------------
 Default arguments for `wp_link_pages()` are already documented in the
 phpDoc, and they should be converted to the hash-notation style, as
 [http://make.wordpress.org/core/handbook/inline-documentation-standards
 /php-documentation-standards/#1-1-parameters-that-are-arrays outlined in
 the inline docs standards].

 Current Reference:
 http://developer.wordpress.org/reference/functions/wp_link_pages/

 A good example of documenting arguments arrays is the
 [https://core.trac.wordpress.org/browser/trunk/src/wp-includes/general-
 template.php#L1156 phpDoc] for `wp_get_archives()` in wp-includes/general-
 template.php.

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


More information about the wp-trac mailing list