[wp-trac] [WordPress Trac] #38811: REST API: ambiguous strings

[WordPress Trac]

#38811: REST API: ambiguous strings
------------------------------+-----------------------
 Reporter:  Presskopp         |       Owner:  joehoyle
     Type:  defect (bug)      |      Status:  assigned
 Priority:  normal            |   Milestone:  4.7
Component:  REST API          |     Version:  trunk
 Severity:  normal            |  Resolution:
 Keywords:  has-patch commit  |     Focuses:  docs
------------------------------+-----------------------

Comment (by SergeyBiryukov):

 Replying to [comment:12 joehoyle]:
 > via the API, CPTs are not called "posts" anywhere, so this language
 would confuse things I think.

 I see a lot of "post type" references in the docs in `class-wp-rest-post-
 types-controller.php`:

 * `Core class to access post types via the REST API.`
 * `Retrieves all public post types.`
 * `Retrieves a specific post type.`
 * `Prepares a post type object for serialization.`
 * `@param stdClass        $post_type Post type data.`
 * `Filters a post type returned from the API.`
 * `Allows modification of the post type data right before it is returned.`
 * `$item     The original post type object.`
 * `Retrieves the post type's schema, conforming to JSON Schema.`

 So I think [attachment:38811.2.patch] makes the strings more consistent
 rather than confusing.

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