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 +4 added lines, -3 removed lines

@@ -120,6 +120,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' );
@@ -377,7 +380,6 @@ 
 	/**
 	 * Get an sha256 hash of a seialized array of parameters
 	 *
-	 * @param string $serialized_parameters A serialized string of a parameter array.
 	 * @return string An sha256 hash
 	 */
 	function get_paramater_hash( $parameters ) {
@@ -387,8 +389,7 @@ 
 	/**
 	 * Validates that a hash of the parameter array matches the included hash parameter
 	 *
-	 * @param array $parameters An array of query parameters.
-	 * @return array An array of the parameters minus the hash
+	 * @return boolean An array of the parameters minus the hash
 	 */
 	function validate_parameters() {
 		if ( empty( $_GET['hash'] ) ) {