Automattic / jetpack

modules/tiled-gallery/tiled-gallery/tiled-gallery-layout.php

Doc Comments +8 added lines

@@ -9,6 +9,11 @@ 
 	public $link;
 	public $grayscale;
 	public $columns;
+
+	/**
+	 * @param boolean $grayscale
+	 * @param integer $columns
+	 */
 	public function __construct( $attachments, $link, $grayscale, $columns ) {
 
 		$this->attachments           = $attachments;
@@ -39,6 +44,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private function template( $name, $context = null ) {
 		if ( ! in_array( $name, self::$templates ) ) {
 			return;

modules/theme-tools/featured-content.php

Doc Comments +1 added lines, -1 removed lines

@@ -699,7 +699,7 @@
 	 * handlers should be copied when the theme context is loaded by the REST API.
 	 *
 	 * @param array $copy_dirs Copy paths with actions to be copied
-	 * @return array Copy paths with featured content plugin
+	 * @return string[] Copy paths with featured content plugin
 	 */
 	function wpcom_rest_api_featured_content_copy_plugin_actions( $copy_dirs ) {
 		$copy_dirs[] = __FILE__;

modules/theme-tools/infinite-scroll.php

Doc Comments -1 removed lines

@@ -40,7 +40,6 @@
 /**
  * Prevent IS from being activated if theme doesn't support it
  *
- * @param bool $can_activate
  * @filter jetpack_can_activate_infinite-scroll
  * @return bool
  */

modules/theme-tools/responsive-videos.php

Doc Comments +1 added lines

@@ -29,6 +29,7 @@
 /**
  * Adds a wrapper to videos and enqueue script
  *
+ * @param string $html
  * @return string
  */
 function jetpack_responsive_videos_embed_html( $html ) {

modules/shortcodes/crowdsignal.php

Doc Comments +3 added lines

@@ -25,6 +25,9 @@
 		add_action( 'infinite_scroll_render', array( $this, 'crowdsignal_shortcode_infinite' ), 11 );
 	}
 
+	/**
+	 * @param string $survey_link
+	 */
 	private function get_async_code( array $settings, $survey_link ) {
 		$include = <<<CONTAINER
 ( function( d, c, j ) {

modules/sitemaps/sitemap-buffer.php

Doc Comments +2 added lines, -2 removed lines

@@ -154,7 +154,7 @@ 
 	 *
 	 * @since 5.3.0
 	 *
-	 * @param array $array The item to be added.
+	 * @param string $array The item to be added.
 	 *
 	 * @return bool True if the append succeeded, False if not.
 	 */
@@ -283,7 +283,7 @@ 
 	 * @param DOMElement  $parent (optional) an element to which new children should be added.
 	 * @param DOMDocument $root (optional) the parent document.
 	 *
-	 * @return string|DOMDocument The rendered XML string or an object if root element is specified.
+	 * @return null|DOMNode The rendered XML string or an object if root element is specified.
 	 */
 	protected function array_to_xml_string( $array, $parent = null, $root = null ) {
 		$return_string = false;

_inc/lib/class.jetpack-keyring-service-helper.php

Doc Comments +8 added lines

@@ -100,6 +100,10 @@ 
 		), menu_page_url( 'sharing', false ) );
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $for
+	 */
 	static function refresh_url( $service_name, $for ) {
 		return add_query_arg( array(
 			'action'   => 'request',
@@ -111,6 +115,10 @@ 
 		), admin_url( 'options-general.php?page=sharing' ) );
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $id
+	 */
 	static function disconnect_url( $service_name, $id ) {
 		return add_query_arg( array(
 			'action'   => 'delete',

_inc/lib/debugger/class-jetpack-cxn-test-base.php

Doc Comments +1 added lines, -1 removed lines

@@ -129,7 +129,7 @@
 	 *
 	 * @param string $group Testing group to check status of. Optional, default all tests.
 	 *
-	 * @return true|array True if all tests pass. Array of failed tests.
+	 * @return boolean True if all tests pass. Array of failed tests.
 	 */
 	public function pass( $group = 'default' ) {
 		$results = $this->raw_results( $group );

modules/protect/math-fallback.php

Doc Comments +2 added lines, -2 removed lines

@@ -26,7 +26,7 @@ 
 		/**
 		 * Verifies that a user answered the math problem correctly while logging in.
 		 *
-		 * @return bool Returns true if the math is correct
+		 * @return boolean|null Returns true if the math is correct
 		 * @throws Error if insuffient $_POST variables are present.
 		 * @throws Error message if the math is wrong
 		 */
@@ -109,7 +109,7 @@ 
 		/**
 		 * Requires a user to solve a simple equation. Added to any WordPress login form.
 		 *
-		 * @return VOID outputs html
+		 * @return string|null outputs html
 		 */
 		static function math_form() {
 			// Check if jpp_math_pass cookie is set and it matches valid transient