Automattic / jetpack

projects/plugins/beta/class-jetpack-beta-admin.php

Doc Comments +1 added lines

@@ -729,6 +729,7 @@
 	 *
 	 * @param string $branch - Branch that's ready for update.
 	 * @param string $section - What kind of branch we're updated (master, rc, pr).
+	 * @return string
 	 */
 	public static function update_action_url( $branch, $section ) {
 		$query = array(

projects/plugins/jetpack/_inc/lib/functions.wp-notify.php

Doc Comments +1 added lines, -1 removed lines

@@ -229,7 +229,7 @@
  *
  * @param string $notify_moderator The value of the moderation_notify option OR if the comment is awaiting moderation.
  * @param int    $comment_id Comment ID.
- * @return boolean Returns false to shortcircuit the execution of wp_notify_moderator
+ * @return string|false Returns false to shortcircuit the execution of wp_notify_moderator
  */
 function jetpack_notify_moderator( $notify_moderator, $comment_id ) {
 	/*

projects/packages/autoloader/src/CustomAutoloaderPlugin.php

Doc Comments +1 added lines, -1 removed lines

@@ -168,7 +168,7 @@
 	/**
 	 * Checks to see whether or not the root package is the one that required the autoloader.
 	 *
-	 * @return bool
+	 * @return null|boolean
 	 */
 	private function isRequiredByRoot() {
 		$package  = $this->composer->getPackage();

projects/plugins/jetpack/modules/memberships/class-jetpack-memberships.php

Doc Comments +2 added lines, -2 removed lines

@@ -193,7 +193,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;
@@ -254,7 +254,7 @@ 
 	 * (because it requires a plan upgrade or Stripe connection), and the
 	 * button is a child of a Premium Content block.
 	 *
-	 * @param WP_Block $block Recurring Payments block instance.
+	 * @param WP_Block|null $block Recurring Payments block instance.
 	 *
 	 * @return boolean
 	 */

projects/packages/connection/src/class-tokens.php

Doc Comments +1 added lines, -1 removed lines

@@ -246,7 +246,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 function update_user_token( $user_id, $token, $is_master_user ) {
 		// Not designed for concurrent updates.

projects/packages/connection/src/class-manager.php

Doc Comments +3 added lines, -3 removed lines

@@ -293,7 +293,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 ) ) {
@@ -1461,7 +1461,7 @@ 
 	/**
 	 * Obtains the auth token.
 	 *
-	 * @param array $data The request data.
+	 * @param string $data The request data.
 	 * @return object|\WP_Error Returns the auth token on success.
 	 *                          Returns a \WP_Error on failure.
 	 */
@@ -2088,7 +2088,7 @@ 
 	 * @deprecated 9.5 Use Automattic\Jetpack\Connection\Tokens->get_signed_token() instead.
 	 *
 	 * @param object $token the token.
-	 * @return WP_Error|string a signed token
+	 * @return string a signed token
 	 */
 	public function get_signed_token( $token ) {
 		_deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Tokens->get_signed_token' );

projects/plugins/jetpack/_inc/lib/class.jetpack-keyring-service-helper.php

Doc Comments +8 added lines

@@ -136,6 +136,10 @@ 
 		);
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $for
+	 */
 	static function refresh_url( $service_name, $for ) {
 		return add_query_arg(
 			array(
@@ -150,6 +154,10 @@ 
 		);
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $id
+	 */
 	static function disconnect_url( $service_name, $id ) {
 		return add_query_arg(
 			array(

projects/packages/password-checker/src/class-password-checker.php

Doc Comments +1 added lines, -1 removed lines

@@ -281,7 +281,7 @@
 	 * @param string $password  the password.
 	 * @param array  $test_data the current test data.
 	 *
-	 * @return bool does the test pass?
+	 * @return integer does the test pass?
 	 */
 	protected function test_preg_match( $password, $test_data ) {
 		return preg_match( $test_data['pattern'], $password );

projects/packages/changelogger/lib/ChangeEntry.php

Doc Comments +1 added lines, -1 removed lines

@@ -165,7 +165,7 @@
 	/**
 	 * Set the timestamp.
 	 *
-	 * @param DateTime|string $timestamp Timestamp to set.
+	 * @param string $timestamp Timestamp to set.
 	 * @returns $this
 	 * @throws InvalidArgumentException If an argument is invalid.
 	 */