From bc917ac0c734f6641178951428e85184496cec48 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Sun, 30 Oct 2016 16:35:30 +0000
Subject: [PATCH] Docs: Add much more complete and syntactically correct
 documentation throughout the `WP_REST_Post_Meta_Fields` class.

Props Soean, mrahmadawais, flixos90.
See #38398.


git-svn-id: https://develop.svn.wordpress.org/trunk@39023 602fd350-edb4-49c9-b593-d223f7449a82
---
 .../fields/class-wp-rest-post-meta-fields.php | 36 ++++++++++++++++---
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/src/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php b/src/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php
index c16460374f..17d87fa44f 100644
--- a/src/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php
+++ b/src/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php
@@ -1,9 +1,26 @@
 <?php
+/**
+ * REST API: WP_REST_Post_Meta_Fields class
+ *
+ * @package WordPress
+ * @subpackage REST_API
+ * @since 4.7.0
+ */
 
+/**
+ * Core class used to manage meta values for posts via the REST API.
+ *
+ * @since 4.7.0
+ *
+ * @see WP_REST_Meta_Fields
+ */
 class WP_REST_Post_Meta_Fields extends WP_REST_Meta_Fields {
+
 	/**
 	 * Post type to register fields for.
 	 *
+	 * @since 4.7.0
+	 * @access protected
 	 * @var string
 	 */
 	protected $post_type;
@@ -11,6 +28,9 @@ class WP_REST_Post_Meta_Fields extends WP_REST_Meta_Fields {
 	/**
 	 * Constructor.
 	 *
+	 * @since 4.7.0
+	 * @access public
+	 *
 	 * @param string $post_type Post type to register fields for.
 	 */
 	public function __construct( $post_type ) {
@@ -18,18 +38,26 @@ class WP_REST_Post_Meta_Fields extends WP_REST_Meta_Fields {
 	}
 
 	/**
-	 * Get the object type for meta.
+	 * Retrieves the object meta type.
 	 *
-	 * @return string
+	 * @since 4.7.0
+	 * @access protected
+	 *
+	 * @return string The meta type.
 	 */
 	protected function get_meta_type() {
 		return 'post';
 	}
 
 	/**
-	 * Get the type for `register_rest_field`.
+	 * Retrieves the type for register_rest_field().
 	 *
-	 * @return string Custom post type slug.
+	 * @since 4.7.0
+	 * @access public
+	 *
+	 * @see register_rest_field()
+	 *
+	 * @return string The REST field type.
 	 */
 	public function get_rest_field_type() {
 		return $this->post_type;