Automattic / jetpack

modules/theme-tools/site-logo/inc/class-site-logo.php

Doc Comments +1 added lines, -1 removed lines

@@ -258,7 +258,7 @@
 	/**
 	 * Reset the site logo if the current logo is deleted in the media manager.
 	 *
-	 * @param int $site_id
+	 * @param int $post_id
 	 * @uses Site_Logo::remove_site_logo()
 	 */
 	public function reset_on_attachment_delete( $post_id ) {

sal/class.json-api-post-base.php

Doc Comments +6 added lines

@@ -16,6 +16,9 @@ 
 	public $context;
 	public $site;
 
+	/**
+	 * @param Jetpack_Site $site
+	 */
 	function __construct( $site, $post, $context ) {
 		$this->post = $post;
 		$this->context = $context;
@@ -508,6 +511,9 @@ 
 		return $suggestions;
 	}
 
+	/**
+	 * @param string $context
+	 */
 	private function format_taxonomy( $taxonomy, $taxonomy_type, $context ) {
 		// Permissions
 		switch ( $context ) {

modules/search/class.jetpack-search-helpers.php

Doc Comments -1 removed lines

@@ -76,7 +76,6 @@
 	 * @since 5.8.0
 	 *
 	 * @param string|array $key   Query key or keys to remove.
-	 * @param bool|string  $query Optional. A URL to act upon.  Defaults to the current search URL.
 	 *
 	 * @return string New URL query string (unescaped).
 	 */

modules/memberships/class-jetpack-memberships.php

Doc Comments +1 added lines, -1 removed lines

@@ -172,7 +172,7 @@
 	 * @param array $post_types - other post types.
 	 *
 	 * @see hook 'rest_api_allowed_post_types'
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_rest_api_types( $post_types ) {
 		$post_types[] = self::$post_type_plan;

3rd-party/qtranslate-x.php

Doc Comments +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
  * @param string $url_orig Original URL.
  * @param array  $url_info  Pieces of original URL.
  *
- * @return bool
+ * @return false|string
  */
 function jetpack_no_qtranslate_rest_url_redirect( $url_lang, $url_orig, $url_info ) {
 	if ( false !== strpos( $url_info['wp-path'], 'wp-json/jetpack' ) ) {

packages/lazy-images/src/lazy-images.php

Doc Comments +1 added lines, -1 removed lines

@@ -55,7 +55,7 @@
 	 *
 	 * @since 5.6.0
 	 *
-	 * @return object The class instance.
+	 * @return Jetpack_Lazy_Images The class instance.
 	 */
 	public static function instance() {
 		if ( is_null( self::$instance ) ) {

packages/connection/src/class-manager.php

Doc Comments +4 added lines, -3 removed lines

@@ -313,7 +313,7 @@ 
 	/**
 	 * Verifies the signature of the current request.
 	 *
-	 * @return false|array
+	 * @return boolean
 	 */
 	public function verify_xml_rpc_signature() {
 		if ( is_null( $this->xmlrpc_verification ) ) {
@@ -1286,6 +1286,7 @@ 
 	 * @param String  $action  The action name.
 	 * @param Integer $user_id The user identifier.
 	 * @param Integer $exp     Expiration time in seconds.
+	 * @return string
 	 */
 	public function generate_secrets( $action, $user_id = false, $exp = 600 ) {
 		if ( false === $user_id ) {
@@ -2242,7 +2243,7 @@ 
 	 *
 	 * @param int|false    $user_id   false: Return the Blog Token. int: Return that user's User Token.
 	 * @param string|false $token_key If provided, check that the token matches the provided input.
-	 * @param bool|true    $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found.
+	 * @param boolean    $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found.
 	 *
 	 * @return object|false
 	 */
@@ -2626,7 +2627,7 @@ 
 	 * Fetches a signed token.
 	 *
 	 * @param object $token the token.
-	 * @return WP_Error|string a signed token
+	 * @return string a signed token
 	 */
 	public function get_signed_token( $token ) {
 		if ( ! isset( $token->secret ) || empty( $token->secret ) ) {

3rd-party/woocommerce.php

Doc Comments +1 added lines, -1 removed lines

@@ -66,7 +66,7 @@
  * Add a callback for WooCommerce product rendering in infinite scroll.
  *
  * @param array $callbacks Array of render callpacks for IS.
- * @return array
+ * @return string[]
  */
 function jetpack_woocommerce_infinite_scroll_render_callback( $callbacks ) {
 	$callbacks[] = 'jetpack_woocommerce_infinite_scroll_render';