Automattic / jetpack

modules/shortcodes/soundcloud.php

Doc Comments +2 added lines, -2 removed lines

@@ -142,7 +142,7 @@ 
 /**
  * Plugin options getter
  *
- * @param  string|array $option  Option name.
+ * @param  string $option  Option name.
  * @param  mixed        $default Default value.
  *
  * @return mixed                   Option value
@@ -158,7 +158,7 @@ 
  *
  * @param string $url Soundcloud URL.
  *
- * @return boolean
+ * @return integer
  */
 function soundcloud_url_has_tracklist( $url ) {
 	return preg_match( '/^(.+?)\/(sets|groups|playlists)\/(.+?)$/', $url );

modules/sharedaddy/sharing-sources.php

Doc Comments +6 added lines

@@ -339,6 +339,9 @@ 
 		do_action( 'sharing_bump_stats', array( 'service' => $this, 'post' => $post ) );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	public function js_dialog( $name, $params = array() ) {
 		if ( true !== $this->open_link_in_new ) {
 			return;
@@ -1458,6 +1461,9 @@ 
 		return __( 'Pinterest', 'jetpack' );
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_image( $post ) {
 		if ( class_exists( 'Jetpack_PostImages' ) ) {
 			$image = Jetpack_PostImages::get_image( $post->ID, array( 'fallback_to_avatars' => true ) );

modules/sitemaps/sitemap-finder.php

Doc Comments +1 added lines, -1 removed lines

@@ -82,7 +82,7 @@
 	 *
 	 * @param string $raw_uri A URI (path+query only) to test for sitemap-ness.
 	 *
-	 * @return array @args {
+	 * @return string @args {
 	 *   @type string $sitemap_name The recognized sitemap name (or null).
 	 * }
 	 */

packages/jetpack-logo/src/Logo.php

Doc Comments +1 added lines, -1 removed lines

@@ -56,7 +56,7 @@
 	 *
 	 * @static
 	 *
-	 * @param string $url Optional custom URL of a Jetpack logo.
+	 * @param string $filename
 	 * @return string The Jetpack logo.
 	 */
 	public function render( $filename = null ) {

packages/jetpack-logo/tests/fixtures.php

Doc Comments +7 added lines

@@ -7,10 +7,17 @@
 	return $URL;
 }
 
+/**
+ * @param string $string
+ * @param string $namespace
+ */
 function esc_attr__( $string, $namespace ) {
 	return $string;
 }
 
+/**
+ * @param string $path
+ */
 function content_url( $path ) {
 	return 'https://example.com/wp-content'. $path;
 }