Automattic / jetpack

class.jetpack-gutenberg.php

Doc Comments +4 added lines, -4 removed lines

@@ -583,7 +583,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
@@ -837,7 +837,7 @@ 
 	 *
 	 * @param string $slug  Block slug.
 	 * @param array  $attr  Block attributes.
-	 * @param array  $extra Potential extra classes you may want to provide.
+	 * @param string[]  $extra Potential extra classes you may want to provide.
 	 *
 	 * @return string $classes List of CSS classes for a block.
 	 */
@@ -934,10 +934,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 (

class.jetpack-client-server.php

Doc Comments +1 added lines, -1 removed lines

@@ -105,7 +105,7 @@
 	/**
 	 * Returns an instance of the Jetpack object.
 	 *
-	 * @return Automattic\Jetpack
+	 * @return Jetpack
 	 */
 	public function get_jetpack() {
 		return Jetpack::init();

_inc/lib/class.jetpack-search-performance-logger.php

Doc Comments +4 added lines

@@ -62,6 +62,10 @@
 		return $query->is_main_query() && $query->is_search();
 	}
 
+	/**
+	 * @param double $duration
+	 * @param boolean $was_jetpack_search
+	 */
 	private function record_query_time( $duration, $was_jetpack_search ) {
 		$this->stats[] = array( $was_jetpack_search, (int) ( $duration * 1000 ) );
 	}

modules/protect/blocked-login-page.php

Doc Comments +4 added lines

@@ -35,6 +35,7 @@ 
 	/**
 	 * Singleton implementation
 	 *
+	 * @param string|false $ip_address
 	 * @return object
 	 */
 	public static function instance( $ip_address ) {
@@ -348,6 +349,9 @@ 
 		return $contents;
 	}
 
+	/**
+	 * @param string $message
+	 */
 	function display_page( $title, $message, $back_button = false, $recovery_form = false ) {
 
 		if ( ! headers_sent() ) {

modules/shortcodes/instagram.php

Doc Comments +1 added lines, -1 removed lines

@@ -145,7 +145,7 @@
  * @param string $url  URL of the content to be embedded.
  * @param array  $atts Shortcode attributes.
  *
- * @return array $params Array of parameters to be used in Instagram query.
+ * @return string $params Array of parameters to be used in Instagram query.
  */
 function jetpack_instagram_get_allowed_parameters( $url, $atts = array() ) {
 	global $content_width;

extensions/blocks/story/story.php

Doc Comments +1 added lines, -1 removed lines

@@ -217,7 +217,7 @@
  * Render a slide
  *
  * @param array $media  Media information.
- * @param array $index  Index of the slide, first slide will be displayed by default, others hidden.
+ * @param integer $index  Index of the slide, first slide will be displayed by default, others hidden.
  *
  * @return string
  */

modules/widgets/milestone/class-milestone-widget.php

Doc Comments +1 added lines, -1 removed lines

@@ -595,7 +595,7 @@
 	 *
 	 * @param array $dirty Unsantized data for the widget.
 	 *
-	 * @return array Santized data.
+	 * @return integer Santized data.
 	 */
 	public function sanitize_instance( $dirty ) {
 		$now = (int) current_time( 'timestamp' ); // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested

modules/widgets/rsslinks-widget.php

Doc Comments +3 added lines

@@ -172,6 +172,9 @@
 		echo '</select></label></p></div>';
 	}
 
+	/**
+	 * @param string $type
+	 */
 	function _rss_link( $type, $args ) {
 		if ( 'posts' == $type ) {
 			$type_text = __( 'Posts', 'jetpack' );