Automattic / jetpack

packages/tracking/legacy/class-jetpack-tracks-client.php

Doc Comments +1 added lines, -1 removed lines

@@ -52,7 +52,7 @@
 	/**
 	 * Record an event.
 	 *
-	 * @param  mixed $event Event object to send to Tracks. An array will be cast to object. Required.
+	 * @param  Jetpack_Tracks_Event $event Event object to send to Tracks. An array will be cast to object. Required.
 	 *                      Properties are included directly in the pixel query string after light validation.
 	 * @return mixed         True on success, WP_Error on failure
 	 */

packages/sync/src/modules/class-constants.php

Doc Comments +2 added lines, -2 removed lines

@@ -158,7 +158,7 @@ 
 	 *
 	 * @param array $config Full sync configuration for this sync module.
 	 *
-	 * @return array Number of items yet to be enqueued.
+	 * @return integer Number of items yet to be enqueued.
 	 */
 	public function estimate_full_sync_actions( $config ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
 		return 1;
@@ -169,7 +169,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @return array Full sync actions of this module.
+	 * @return string[] Full sync actions of this module.
 	 */
 	public function get_full_sync_actions() {
 		return array( 'jetpack_full_sync_constants' );

packages/sync/src/modules/class-module.php

Doc Comments +4 added lines, -4 removed lines

@@ -67,7 +67,7 @@ 
 	 *
 	 * @param string $object_type Type of the sync object.
 	 * @param int    $id          ID of the sync object.
-	 * @return mixed Object, or false if the object is invalid.
+	 * @return boolean Object, or false if the object is invalid.
 	 */
 	public function get_object_by_id( $object_type, $id ) {
 		return false;
@@ -166,8 +166,8 @@ 
 	 * @access protected
 	 *
 	 * @param array $action_names     Action names we're interested in.
-	 * @param array $actions_to_count Unfiltered list of actions we want to count.
-	 * @return array Number of actions that we're interested in.
+	 * @param string[] $actions_to_count Unfiltered list of actions we want to count.
+	 * @return integer Number of actions that we're interested in.
 	 */
 	protected function count_actions( $action_names, $actions_to_count ) {
 		return count( array_intersect( $action_names, $actions_to_count ) );
@@ -266,7 +266,7 @@ 
 	/**
 	 * Given the Module Full Sync Configuration and Status return the next chunk of items to send.
 	 *
-	 * @param array $config This module Full Sync configuration.
+	 * @param string $config This module Full Sync configuration.
 	 * @param array $status This module Full Sync status.
 	 * @param int   $chunk_size Chunk size.
 	 *

packages/sync/src/modules/class-full-sync-immediately.php

Doc Comments +1 added lines, -1 removed lines

@@ -149,7 +149,7 @@
 	 *
 	 * @access public
 	 *
-	 * @return int|null
+	 * @return null|double
 	 */
 	public function get_sync_progress_percentage() {
 		if ( ! $this->is_started() || $this->is_finished() ) {

packages/sync/src/modules/class-full-sync.php

Doc Comments +2 added lines, -2 removed lines

@@ -411,7 +411,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @return int|null
+	 * @return null|double
 	 */
 	public function get_sync_progress_percentage() {
 		if ( ! $this->is_started() || $this->is_finished() ) {
@@ -625,7 +625,7 @@ 
 	 * @access private
 	 *
 	 * @param string $name    Name of the option.
-	 * @param mixed  $default Default value of the option.
+	 * @param integer  $default Default value of the option.
 	 * @return mixed Option value.
 	 */
 	private function get_status_option( $name, $default = null ) {

sal/class.json-api-site-jetpack.php

Doc Comments +6 added lines

@@ -165,6 +165,9 @@ 
 		return $this->get_atomic_cloud_site_option( 'launch-status' );
 	}
 
+	/**
+	 * @param string $option
+	 */
 	function get_atomic_cloud_site_option( $option ) {
 		if ( ! jetpack_is_atomic_site() ) {
 			return false;
@@ -233,6 +236,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $role
+	 */
 	function current_user_can( $role ) {
 		return current_user_can( $role );
 	}

packages/sync/src/modules/class-users.php

Doc Comments +4 added lines, -4 removed lines

@@ -205,7 +205,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @param \WP_User $user User object.
+	 * @param \WP_User|null $user User object.
 	 * @return \WP_User Expanded user object.
 	 */
 	public function expand_user( $user ) {
@@ -545,7 +545,7 @@ 
 	 * @access public
 	 *
 	 * @param int $user_id ID of the user.
-	 * @return array Current flags of the user.
+	 * @return string Current flags of the user.
 	 */
 	public function get_flags( $user_id ) {
 		if ( isset( $this->flags[ $user_id ] ) ) {
@@ -636,7 +636,7 @@ 
 	 * @todo Refactor to prepare the SQL query before executing it.
 	 *
 	 * @param array $config Full sync configuration for this sync module.
-	 * @return array Number of items yet to be enqueued.
+	 * @return integer Number of items yet to be enqueued.
 	 */
 	public function estimate_full_sync_actions( $config ) {
 		global $wpdb;
@@ -680,7 +680,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @return array Full sync actions of this module.
+	 * @return string[] Full sync actions of this module.
 	 */
 	public function get_full_sync_actions() {
 		return array( 'jetpack_full_sync_users' );

packages/tracking/src/class-tracking.php

Doc Comments +2 added lines, -2 removed lines

@@ -119,8 +119,8 @@
 	/**
 	 * Determines whether tracking should be enabled.
 	 *
-	 * @param Automattic\Jetpack\Terms_Of_Service $terms_of_service A Terms_Of_Service object.
-	 * @param Automattic\Jetpack\Status           $status A Status object.
+	 * @param Terms_Of_Service $terms_of_service A Terms_Of_Service object.
+	 * @param Status           $status A Status object.
 	 *
 	 * @return boolean True if tracking should be enabled, else false.
 	 */