Automattic / jetpack

class.jetpack-gutenberg.php

Doc Comments +3 added lines, -3 removed lines

@@ -518,7 +518,7 @@ 
 	 * Only enqueue block assets when needed.
 	 *
 	 * @param string $type Slug of the block.
-	 * @param array  $script_dependencies Script dependencies. Will be merged with automatically
+	 * @param string[]  $script_dependencies Script dependencies. Will be merged with automatically
 	 *                                    detected script dependencies from the webpack build.
 	 *
 	 * @return void
@@ -866,10 +866,10 @@ 
 	 * @since 8.3.0
 	 *
 	 * @param string $url      URL saved as an attribute in block.
-	 * @param array  $allowed  Array of allowed hosts for that block, or regexes to check against.
+	 * @param string[]  $allowed  Array of allowed hosts for that block, or regexes to check against.
 	 * @param bool   $is_regex Array of regexes matching the URL that could be used in block.
 	 *
-	 * @return bool|string
+	 * @return false|string
 	 */
 	public static function validate_block_embed_url( $url, $allowed = array(), $is_regex = false ) {
 		if (

modules/widgets/instagram/instagram.php

Doc Comments +6 added lines

@@ -147,6 +147,9 @@ 
 		return $data;
 	}
 
+	/**
+	 * @param string $path
+	 */
 	private function wpcom_json_api_request_as_blog( $path, $version = 1, $args = array(), $body = null, $base_api_path = 'rest' ) {
 		if ( ! class_exists( 'Jetpack_Client' ) ) {
 			return new WP_Error( 'missing_jetpack', 'The `Jetpack_Client` class is missing' );
@@ -262,6 +265,9 @@ 
 		return $url;
 	}
 
+	/**
+	 * @return boolean
+	 */
 	private function is_legacy_token( $token_id ) {
 		$site = Jetpack_Options::get_option( 'id' );
 		$path = sprintf( '/sites/%s/instagram/%s/check-legacy', $site, $token_id );