Automattic / jetpack

modules/gravatar-hovercards.php

Doc Comments +1 added lines, -1 removed lines

@@ -154,7 +154,7 @@
  * @param string $avatar The <img/> element of the avatar.
  * @param mixed $author User ID, email address, user login, comment object, user object, post object
  *
- * @return The <img/> element of the avatar.
+ * @return string <img/> element of the avatar.
  */
 function grofiles_get_avatar( $avatar, $author ) {
 	$is_amp = class_exists( 'Jetpack_AMP_Support' ) && Jetpack_AMP_Support::is_amp_request();

modules/woocommerce-analytics/classes/class-jetpack-woocommerce-analytics-universal.php

Doc Comments +1 added lines, -1 removed lines

@@ -310,7 +310,7 @@
 	/**
 	 * Get the current user id
 	 *
-	 * @return int
+	 * @return string
 	 */
 	public function get_user_id() {
 		if ( is_user_logged_in() ) {

modules/subscriptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -514,7 +514,7 @@
 	 * Send a synchronous XML-RPC subscribe to blog posts or subscribe to post comments request.
 	 *
 	 * @param string $email
-	 * @param array  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
+	 * @param integer  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
 	 * @param bool   $async    (optional) Should the subscription be performed asynchronously?  Defaults to true.
 	 *
 	 * @return true|WP_Error true on success

modules/wordads/class-wordads.php

Doc Comments +2 added lines, -2 removed lines

@@ -118,7 +118,7 @@ 
 	 * Convenience function for grabbing options from params->options
 	 *
 	 * @param  string $option the option to grab.
-	 * @param  mixed  $default (optional).
+	 * @param  boolean  $default (optional).
 	 * @return option or $default if not set
 	 *
 	 * @since 4.5.0
@@ -710,7 +710,7 @@ 
 	/**
 	 * Check the reasons to bail before we attempt to insert ads.
 	 *
-	 * @return true if we should bail (don't insert ads)
+	 * @return boolean if we should bail (don't insert ads)
 	 *
 	 * @since 4.5.0
 	 */

modules/wordads/php/class-wordads-sidebar-widget.php

Doc Comments +1 added lines, -1 removed lines

@@ -47,7 +47,7 @@
 	 * @param array $args Widget args.
 	 * @param array $instance The Widget instance.
 	 *
-	 * @return bool|void
+	 * @return false|null
 	 */
 	public function widget( $args, $instance ) {
 		global $wordads;

json-endpoints/class.wpcom-json-api-list-posts-v1-1-endpoint.php

Doc Comments +3 added lines

@@ -433,6 +433,9 @@
 		);
 	}
 
+	/**
+	 * @param string $column
+	 */
 	function _build_date_range_query( $column, $range, $where ) {
 		global $wpdb;
 

_inc/lib/core-api/load-wpcom-endpoints.php

Doc Comments +3 added lines

@@ -15,6 +15,9 @@
 	exit;
 }
 
+/**
+ * @param string $file_pattern
+ */
 function wpcom_rest_api_v2_load_plugin_files( $file_pattern ) {
 	$plugins = glob( dirname( __FILE__ ) . '/' . $file_pattern );
 

modules/videopress/class.videopress-video.php

Doc Comments +1 added lines

@@ -174,6 +174,7 @@
 	 * @since 1.3
 	 * @var string $guid VideoPress unique identifier
 	 * @var int $maxwidth maximum requested video width. final width and height are calculated on VideoPress servers based on the aspect ratio of the original video upload.
+	 * @param string $guid
 	 */
 	public function __construct( $guid, $maxwidth = 640 ) {
 		$this->guid = $guid;

class.photon.php

Doc Comments +2 added lines, -2 removed lines

@@ -42,7 +42,7 @@ 
 	/**
 	 * Singleton implementation
 	 *
-	 * @return object
+	 * @return Jetpack_Photon|null
 	 */
 	public static function instance() {
 		if ( ! is_a( self::$instance, 'Jetpack_Photon' ) ) {
@@ -1382,7 +1382,7 @@ 
 	 * after ourselves without breaking anyone else's filters.
 	 *
 	 * @internal
-	 * @return true
+	 * @return boolean
 	 */
 	public function override_image_downsize_in_rest_edit_context() {
 		return true;