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

Sat Oct 19 20:03:19 UTC 2013

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

 * cc: toscho (added)

Comment:

 One simple way to find related related posts would be the Trac ticket
 number. In some docs, this number is available, so we could store its
 value in a post meta field. Unfortunately, there seems to be no standard.
 I found four different variants in `wp-includes/functions.php`:

 {{{
 // see http://core.trac.wordpress.org/ticket/9396

 <!DOCTYPE html>
 <!-- Ticket #11289, IE bug fix: /* snip */
 -->

  * See http://core.trac.wordpress.org/ticket/8497

  * @link http://core.trac.wordpress.org/ticket/19589
 }}}

 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?

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