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/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.
 	 */

projects/packages/changelogger/lib/KeepAChangelogParser.php

Doc Comments +1 added lines

@@ -89,6 +89,7 @@
 	 *
 	 * @param string   $haystack String to split.
 	 * @param string[] ...$needles Strings to split on. Earliest match in $haystack wins.
+	 * @param string $needles
 	 * @return string[] Two elements: The part before $needles and the part after, both trimmed.
 	 */
 	private function split( $haystack, ...$needles ) {

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

Doc Comments +1 added lines

@@ -43,6 +43,7 @@
 	 * @param String       $action       The action name.
 	 * @param Integer|bool $user_id The user identifier. Defaults to `false`.
 	 * @param Integer      $exp          Expiration time in seconds.
+	 * @return string|boolean
 	 */
 	public function generate( $action, $user_id = false, $exp = 600 ) {
 		if ( false === $user_id ) {