Make it easy to see the return type object structure.

[StevenDufresne]

Target: New WordPress developers

Example Journey: I want to find post data.

• I find my way to: get_post
• I scroll down to "Return" and click on "WP_Post"
• I end up on wp_post
• I am expecting to see a property list since it's an object
• Instead, I have to read through the source to find its structure
  • The source is long and I can't see properties quickly
  • The properties are not alphabetically sorted.
  • I see functions that start with __ which seem like noise.
  • I see $post_status = "publish", what other statuses are there? -> Deadend

Outcome
Users have decided to post the data structure as comments 😞 .

[iandunn]

Yeah, on get_post() it'd be nice to have a few examples of the return data.

On wp_post(), it'd be nice to have a Members section that corresponds to the Methods section.