[wp-meta] [Making WordPress.org] #177: Add cross referencing throughout code reference

Making WordPress.org noreply at wordpress.org
Wed Oct 30 19:16:38 UTC 2013


#177: Add cross referencing throughout code reference
---------------------------+-------------------------------------
  Reporter:  samuelsidler  |      Owner:
      Type:  enhancement   |     Status:  new
  Priority:  normal        |  Component:  developer.wordpress.org
Resolution:                |   Keywords:
---------------------------+-------------------------------------

Comment (by kpdesign):

 Replying to [comment:3 toscho]:
 > It would be nice to have a standard. We could extend the PHP doc
 standard with a new tag and a vendor prefix:
 >
 > {{{
 >  * @wp-ticket http://core.trac.wordpress.org/ticket/19589
 > }}}
 >
 > Not sure what the best place is to discuss that topic. Make? Core trac?
 Chat? This trac?

 All links to Trac tickets and other external documentation will be handled
 using the `@link` tag in the doc blocks. References to other
 functions/classes/hooks/etc. will be done using the `@see` tag.

 We are trying to stay away from using any custom tags in the doc blocks.

 We're aware of the inconsistencies, and are working hard to fix them.

 You, and anyone else, are always welcome to attend our weekly inline docs
 chat, Wednesdays at 18:00 UTC in #wordpress-sfd, or reach out to
 @DrewAPicture or myself with questions in between meetings. :)

--
Ticket URL: <http://meta.trac.wordpress.org/ticket/177#comment:5>
Making WordPress.org <http://meta.trac.wordpress.org/>
WordPress blogging software


More information about the wp-meta mailing list