[wp-trac] [WordPress Trac] #25283: Clean up Inline Docs for revisions

WordPress Trac noreply at wordpress.org
Sat Sep 14 04:18:14 UTC 2013


#25283: Clean up Inline Docs for revisions
-----------------------------+--------------------
 Reporter:  adamsilverstein  |       Owner:
     Type:  enhancement      |      Status:  new
 Priority:  normal           |   Milestone:  3.7
Component:  Inline Docs      |     Version:  trunk
 Severity:  normal           |  Resolution:
 Keywords:  needs-patch      |
-----------------------------+--------------------

Comment (by nacin):

 Replying to [comment:10 DrewAPicture]:
 > We talked a little bit about "private" filters when writing the inline
 docs standards, though it was never really clear what the significance of
 prepending an underscore to a filter hook was actually supposed to be.

 Private filters should be documented with, at the very least, `@access
 private`, the same way documented filters should be documented with
 `@deprecated`.

 That said: I don't think this hook is private. I think it just mimics the
 name of the related function `_wp_post_revision_fields()`.

--
Ticket URL: <http://core.trac.wordpress.org/ticket/25283#comment:13>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software


More information about the wp-trac mailing list