Automattic / jetpack

_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/' ) ) {

packages/connection/src/class-utils.php

Doc Comments +1 added lines, -1 removed lines

@@ -45,7 +45,7 @@
 	 * @param int    $user_id The user id.
 	 * @param string $token The user token.
 	 * @param bool   $is_master_user Whether the user is the master user.
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public static function update_user_token( $user_id, $token, $is_master_user ) {
 		// Not designed for concurrent updates.

packages/redirect/tests/php/bootstrap.php

Doc Comments +4 added lines

@@ -92,6 +92,10 @@
 	return $ret;
 }
 
+/**
+ * @param string $prefix
+ * @param string $sep
+ */
 function _http_build_query( $data, $prefix = null, $sep = null, $key = '', $urlencode = true ) {
 	$ret = array();
 

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();

packages/jitm/src/class-post-connection-jitm.php

Doc Comments +1 added lines, -1 removed lines

@@ -103,7 +103,7 @@
 	 *
 	 * @param string $content The current message.
 	 *
-	 * @return array The new message.
+	 * @return string The new message.
 	 */
 	public static function jitm_woocommerce_services_msg( $content ) {
 		if ( ! function_exists( 'wc_get_base_location' ) ) {

_inc/lib/core-api/wpcom-endpoints/class-wpcom-rest-api-v2-endpoint-external-media.php

Doc Comments +1 added lines, -1 removed lines

@@ -297,7 +297,7 @@
 	 * Returns a download URL, dealing with Google's long file names.
 	 *
 	 * @param array $guid Media information.
-	 * @return string|\WP_Error
+	 * @return string
 	 */
 	public function get_download_url( $guid ) {
 		$this->tmp_name = $guid['name'];