[wp-trac] [WordPress Trac] #64224: Docblock improvements for 7.0

[WordPress Trac]

#64224: Docblock improvements for 7.0
----------------------------+-------------------------------
 Reporter:  desrosj         |       Owner:  (none)
     Type:  task (blessed)  |      Status:  new
 Priority:  normal          |   Milestone:  7.0
Component:  General         |     Version:
 Severity:  normal          |  Resolution:
 Keywords:  has-patch       |     Focuses:  coding-standards
----------------------------+-------------------------------

Comment (by SergeyBiryukov):

 In [changeset:"61998" 61998]:
 {{{
 #!CommitTicketReference repository="" revision="61998"
 Docs: Explicitly document the `rest_revision_query` filter.

 The `rest_revision_query` filter in
 `WP_REST_Revisions_Controller::get_items()` carried a cross-reference
 comment claiming it was documented in the posts controller. This was
 incorrect, as the posts controller documents
 `rest_{$this->post_type}_query` — a dynamic hook that fires only for post
 types managed by `WP_REST_Posts_Controller`.

 `WP_REST_Revisions_Controller` extends `WP_REST_Controller` directly (not
 the posts controller), so the dynamic hook never fires for revisions.
 `rest_revision_query` is a standalone hook and has never had its own
 PHPDoc block.

 Follow-up to [43584].

 Props apermo, mukesh27, SergeyBiryukov.
 See #64224.
 }}}

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