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 (

_inc/lib/class-jetpack-podcast-helper.php

Doc Comments +1 added lines, -1 removed lines

@@ -58,7 +58,7 @@
 	 * Loads an RSS feed using `fetch_feed`.
 	 *
 	 * @param string $feed        The RSS feed URL to load.
-	 * @return SimplePie|WP_Error The RSS object or error.
+	 * @return string The RSS object or error.
 	 */
 	private static function load_feed( $feed ) {
 		$rss = fetch_feed( esc_url_raw( $feed ) );

extensions/blocks/podcast-player/podcast-player.php

Doc Comments +1 added lines, -1 removed lines

@@ -235,7 +235,7 @@
  * @param string $name           Template name, available in `./templates` folder.
  * @param array  $template_props Template properties. Optional.
  * @param bool   $print          Render template. True as default.
- * @return false|string          HTML markup or false.
+ * @return string|null          HTML markup or false.
  */
 function render( $name, $template_props = array(), $print = true ) {
 	if ( ! strpos( $name, '.php' ) ) {

modules/sharedaddy/recaptcha.php

Doc Comments +1 added lines, -1 removed lines

@@ -68,7 +68,7 @@
 	/**
 	 * Get default config for this reCAPTCHA instance.
 	 *
-	 * @return array Default config
+	 * @return string Default config
 	 */
 	public function get_default_config() {
 		return array(

_inc/lib/class.core-rest-api-endpoints.php

Doc Comments -1 removed lines

@@ -1264,7 +1264,6 @@
 	 *
 	 * @since 4.3.0
 	 *
-	 * @param WP_REST_Request $request The request sent to the WP REST API.
 	 *
 	 * @return object
 	 */

modules/shortcodes/getty.php

Doc Comments +1 added lines, -1 removed lines

@@ -86,7 +86,7 @@
  *
  * @param string $content Post content.
  *
- * @return mixed
+ * @return string
  */
 function wpcom_shortcodereverse_getty( $content ) {
 	if ( ! is_string( $content ) || false === stripos( $content, '.gettyimages.com/' ) ) {

3rd-party/class-jetpack-bbpress-rest-api.php

Doc Comments +2 added lines, -2 removed lines

@@ -45,7 +45,7 @@ 
 	 *
 	 * @param array $allowed_post_types Allowed post types.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_bbpress_post_types( $allowed_post_types ) {
 		$allowed_post_types[] = 'forum';
@@ -59,7 +59,7 @@ 
 	 *
 	 * @param array $allowed_meta_keys Allowed meta keys.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_bbpress_public_metadata( $allowed_meta_keys ) {
 		$allowed_meta_keys[] = '_bbp_forum_id';

_inc/lib/class.jetpack-password-checker.php

Doc Comments +1 added lines, -1 removed lines

@@ -410,7 +410,7 @@
 	 *
 	 * @param Mixed $needle the needle.
 	 * @param array $haystack the haystack.
-	 * @return is the needle not in the haystack?
+	 * @return boolean the needle not in the haystack?
 	 */
 	protected function negative_in_array( $needle, $haystack ) {
 		if ( in_array( $needle, $haystack, true ) ) {

_inc/lib/class-jetpack-instagram-gallery-helper.php

Doc Comments +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
 	 *
 	 * @param  string $access_token The Instagram access token.
 	 * @param  int    $count        The number of Instagram posts to fetch.
-	 * @return mixed
+	 * @return integer|null
 	 */
 	public static function get_instagram_gallery( $access_token, $count ) {
 		$site_id = self::get_site_id();