Automattic / jetpack

projects/plugins/jetpack/json-endpoints/jetpack/class.jetpack-json-api-plugins-modify-endpoint.php

Doc Comments +3 added lines

@@ -250,6 +250,9 @@
 		}
 	}
 
+	/**
+	 * @param string $capability
+	 */
 	protected function current_user_can( $capability, $plugin = null ) {
 		// If this endpoint accepts site based authentication and a blog token is used, skip capabilities check.
 		if ( $this->accepts_site_based_authentication() ) {

projects/packages/jitm/src/class-jitm.php

Doc Comments +1 added lines, -1 removed lines

@@ -253,7 +253,7 @@
 	 *
 	 * The list includes an empty string, which is used when no icon should be displayed.
 	 *
-	 * @return array The list of supported icons.
+	 * @return string[] The list of supported icons.
 	 */
 	public function get_supported_icons() {
 		return array(

projects/packages/sync/src/class-functions.php

Doc Comments +3 added lines, -3 removed lines

@@ -186,7 +186,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known constants.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_constant() {
 		$hosting_provider_constants = array(
@@ -214,7 +214,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known classes.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_class() {
 		$hosting_provider = false;
@@ -231,7 +231,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known functions.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_function() {
 		$hosting_provider = false;

projects/packages/connection/src/class-urls.php

Doc Comments +1 added lines, -1 removed lines

@@ -380,7 +380,7 @@
 	 *
 	 * @param string   $option Option value from the site.
 	 * @param callable $url_function Function retrieving the URL to normalize.
-	 * @return mixed|string URL.
+	 * @return callable URL.
 	 */
 	public static function normalize_www_in_url( $option, $url_function ) {
 		$url        = wp_parse_url( call_user_func( $url_function ) );

projects/packages/sync/src/class-rest-endpoints.php

Doc Comments +1 added lines, -1 removed lines

@@ -766,7 +766,7 @@
 	 *
 	 * @param string $item Sync item identifier.
 	 *
-	 * @return string|string[]|null
+	 * @return null|string
 	 */
 	protected static function sanitize_item_ids( $item ) {
 		// lets not delete any options that don't start with jpsq_sync- .