Automattic / jetpack

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-updates.php

Doc Comments +6 added lines

@@ -69,6 +69,9 @@ 
 		$this->assertTrue( (bool) $has_action );
 	}
 
+	/**
+	 * @param string $new_version
+	 */
 	function new_plugin_response( $new_version ) {
 		return (object) array(
 			'response' => array(
@@ -131,6 +134,9 @@ 
 		$this->assertTrue( (bool) $has_action );
 	}
 
+	/**
+	 * @param string $new_version
+	 */
 	public function new_theme_response( $new_version ) {
 		return (object) array(
 			'response' => array(

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-woocommerce.php

Doc Comments +4 added lines

@@ -312,6 +312,10 @@
 		}
 	}
 
+	/**
+	 * @param string $expected_meta_key
+	 * @param integer $expected_meta_value
+	 */
 	private function assertHasObjectMetaValue( $metas, $order_item_id, $expected_meta_key, $expected_meta_value ) {
 		$has_meta_entry = false;
 		foreach( $metas as $meta ) {

projects/plugins/jetpack/tests/php/sync/test_interface.jetpack-sync-replicastore.php

Doc Comments +3 added lines

@@ -1032,6 +1032,9 @@
 		return $return;
 	}
 
+	/**
+	 * @param string $slug
+	 */
 	private function ensure_synced_taxonomy( $store, $slug, $type = 'post' ) {
 		register_taxonomy(
 			$slug,

projects/plugins/jetpack/tests/php/lib/wpcom-helper-functions.php

Doc Comments +1 added lines

@@ -13,6 +13,7 @@
 
 /**
  * Wrapper around `WP_REST_Request` constructor. Injects a `sites/$blog_id` into endpoint string for WPCOM environment
+ * @param string $path
  */
 function wp_rest_request( $method, $path ) {
 	if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {

projects/plugins/jetpack/_inc/lib/core-api/wpcom-fields/class-wpcom-rest-api-v2-attachment-videopress-data.php

Doc Comments +5 added lines, -5 removed lines

@@ -103,7 +103,7 @@ 
 	 *
 	 * @param object $attachment The attachment object.
 	 *
-	 * @return false|int
+	 * @return boolean
 	 */
 	public function is_video( $attachment ) {
 		return isset( $attachment->post_mime_type ) && wp_startswith( $attachment->post_mime_type, 'video/' );
@@ -113,8 +113,8 @@ 
 	 * Removes the jetpack_videopress field from the response if the
 	 * given attachment is not a video.
 	 *
-	 * @param WP_REST_Response $response Response from the attachment endpoint.
-	 * @param WP_Post          $attachment The original attachment object.
+	 * @param stdClass $response Response from the attachment endpoint.
+	 * @param stdClass          $attachment The original attachment object.
 	 *
 	 * @return mixed
 	 */
@@ -146,7 +146,7 @@ 
 	 * @param mixed           $object Response from the attachment endpoint.
 	 * @param WP_REST_Request $request Request to the attachment endpoint.
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function get_permission_check( $object, $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
 		return true;
@@ -160,7 +160,7 @@ 
 	 * @param WP_Post         $object The attachment object.
 	 * @param WP_REST_Request $request Request to the attachment endpoint.
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function update_permission_check( $value, $object, $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
 		return true;

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

Doc Comments +10 added lines

@@ -99,6 +99,9 @@ 
 		exit();
 	}
 
+	/**
+	 * @param string $option
+	 */
 	static function is_toggle_action( $option ) {
 		return (
 			isset( $_GET['_nonce'] ) &&
@@ -316,6 +319,9 @@ 
 		<?php
 	}
 
+	/**
+	 * @param string $header
+	 */
 	static function show_tag( $header, $tag, $url = null, $section = null, $is_last = false ) {
 		$is_compact = $is_last ? '' : 'is-compact';
 		if ( isset( $url ) ) {
@@ -532,6 +538,10 @@ 
 		self::show_toggle( __( 'Email Notifications', 'jetpack-beta' ), 'email_notifications', $email_notification );
 	}
 
+	/**
+	 * @param string $option
+	 * @param boolean $value
+	 */
 	static function show_toggle( $name, $option, $value ) {
 		$query = array(
 			'page'    => 'jetpack-beta',

lib/RationalOptionPages.php

Doc Comments -1 removed lines

@@ -769,7 +769,6 @@
 	/**
 	 * Validates the information submitted to the class
 	 *
-	 * @param	string	$page_key		Array key of the page
 	 * @param	array	$page			Array of page parameters
 	 * @param	string	$parent_slug	Menu slug of the parent page if there is one
 	 *