From 20b93039f30dba8e7dd2379ed2db973a6400fe0b Mon Sep 17 00:00:00 2001
From: desrosj <desrosj@git.wordpress.org>
Date: Fri, 2 Jul 2021 18:55:00 +0000
Subject: [PATCH] Docs: Add missing `@since` tags for some REST API methods
 added in 5.8.

Follow-up to [50995], [51021].

Props SergeyBiryukov.
Merges [51280] to the 5.8 branch.
See #52628, #53461.
Built from https://develop.svn.wordpress.org/branches/5.8@51311


git-svn-id: http://core.svn.wordpress.org/branches/5.8@50920 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 .../class-wp-rest-pattern-directory-controller.php          | 4 ++++
 .../endpoints/class-wp-rest-sidebars-controller.php         | 2 ++
 .../endpoints/class-wp-rest-widget-types-controller.php     | 6 ++++++
 wp-includes/version.php                                     | 2 +-
 4 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php
index 046c0a8369..1c54865e66 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php
@@ -21,6 +21,8 @@ class WP_REST_Pattern_Directory_Controller extends WP_REST_Controller {
 
 	/**
 	 * Constructs the controller.
+	 *
+	 * @since 5.8.0
 	 */
 	public function __construct() {
 		$this->namespace     = 'wp/v2';
@@ -29,6 +31,8 @@ class WP_REST_Pattern_Directory_Controller extends WP_REST_Controller {
 
 	/**
 	 * Registers the necessary REST API routes.
+	 *
+	 * @since 5.8.0
 	 */
 	public function register_routes() {
 		register_rest_route(
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php
index 3ab7dc993b..e6ccd1f0a5 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php
@@ -365,6 +365,8 @@ class WP_REST_Sidebars_Controller extends WP_REST_Controller {
 	/**
 	 * Retrieves the block type' schema, conforming to JSON Schema.
 	 *
+	 * @since 5.8.0
+	 *
 	 * @return array Item schema data.
 	 */
 	public function get_item_schema() {
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
index 7853c73920..33fbcfa385 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
@@ -413,6 +413,8 @@ class WP_REST_Widget_Types_Controller extends WP_REST_Controller {
 	 * - form:     The widget's admin form after updating the widget with the
 	 *             given form data.
 	 *
+	 * @since 5.8.0
+	 *
 	 * @global WP_Widget_Factory $wp_widget_factory
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
@@ -507,6 +509,8 @@ class WP_REST_Widget_Types_Controller extends WP_REST_Controller {
 	 * Returns the output of WP_Widget::widget() when called with the provided
 	 * instance. Used by encode_form_data() to preview a widget.
 
+	 * @since 5.8.0
+	 *
 	 * @param string    $widget   The widget's PHP class name (see class-wp-widget.php).
 	 * @param array     $instance Widget instance settings.
 	 * @return string
@@ -521,6 +525,8 @@ class WP_REST_Widget_Types_Controller extends WP_REST_Controller {
 	 * Returns the output of WP_Widget::form() when called with the provided
 	 * instance. Used by encode_form_data() to preview a widget's form.
 	 *
+	 * @since 5.8.0
+	 *
 	 * @param WP_Widget $widget_object Widget object to call widget() on.
 	 * @param array     $instance Widget instance settings.
 	 * @return string
diff --git a/wp-includes/version.php b/wp-includes/version.php
index d60173e559..679991c136 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.8-RC1-51310';
+$wp_version = '5.8-RC1-51311';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.