Automattic / jetpack

packages/analyzer/src/class-differences.php

Doc Comments +3 added lines

@@ -9,6 +9,9 @@
 
 class Differences extends PersistentList {
 
+	/**
+	 * @param string $path
+	 */
 	private function slashit( $path ) {
 		$path .= ( substr( $path, -1 ) == '/' ? '' : '/' );
 		return $path;

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-api.php

Doc Comments +4 added lines, -4 removed lines

@@ -68,7 +68,7 @@ 
 	/**
 	 * Returns status of WordAds approval.
 	 *
-	 * @return boolean true if site is WordAds approved
+	 * @return string true if site is WordAds approved
 	 *
 	 * @since 4.5.0
 	 */
@@ -83,7 +83,7 @@ 
 	/**
 	 * Returns status of WordAds active.
 	 *
-	 * @return boolean true if ads are active on site
+	 * @return string true if ads are active on site
 	 *
 	 * @since 4.5.0
 	 */
@@ -98,7 +98,7 @@ 
 	/**
 	 * Returns status of WordAds house ads.
 	 *
-	 * @return boolean true if WP.com house ads should be shown
+	 * @return string true if WP.com house ads should be shown
 	 *
 	 * @since 4.5.0
 	 */
@@ -114,7 +114,7 @@ 
 	/**
 	 * Returns whether or not this site is safe to run ads on.
 	 *
-	 * @return boolean true if ads shown not be shown on this site.
+	 * @return string true if ads shown not be shown on this site.
 	 *
 	 * @since 6.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 );
 

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;

class.jetpack-gutenberg.php

Doc Comments +4 added lines, -4 removed lines

@@ -583,7 +583,7 @@ 
 	 * Only enqueue block assets when needed.
 	 *
 	 * @param string $type Slug of the block.
-	 * @param array  $script_dependencies Script dependencies. Will be merged with automatically
+	 * @param string[]  $script_dependencies Script dependencies. Will be merged with automatically
 	 *                                    detected script dependencies from the webpack build.
 	 *
 	 * @return void
@@ -837,7 +837,7 @@ 
 	 *
 	 * @param string $slug  Block slug.
 	 * @param array  $attr  Block attributes.
-	 * @param array  $extra Potential extra classes you may want to provide.
+	 * @param string[]  $extra Potential extra classes you may want to provide.
 	 *
 	 * @return string $classes List of CSS classes for a block.
 	 */
@@ -934,10 +934,10 @@ 
 	 * @since 8.3.0
 	 *
 	 * @param string $url      URL saved as an attribute in block.
-	 * @param array  $allowed  Array of allowed hosts for that block, or regexes to check against.
+	 * @param string[]  $allowed  Array of allowed hosts for that block, or regexes to check against.
 	 * @param bool   $is_regex Array of regexes matching the URL that could be used in block.
 	 *
-	 * @return bool|string
+	 * @return false|string
 	 */
 	public static function validate_block_embed_url( $url, $allowed = array(), $is_regex = false ) {
 		if (

class.jetpack-client-server.php

Doc Comments +1 added lines, -1 removed lines

@@ -105,7 +105,7 @@
 	/**
 	 * Returns an instance of the Jetpack object.
 	 *
-	 * @return Automattic\Jetpack
+	 * @return Jetpack
 	 */
 	public function get_jetpack() {
 		return Jetpack::init();