Automattic / jetpack

projects/plugins/jetpack/modules/sso/class.jetpack-sso-helpers.php

Doc Comments +2 added lines, -2 removed lines

@@ -177,10 +177,10 @@
 	 * @since 4.3.0
 	 * @since 4.6.0 Added public-api.wordpress.com as an allowed redirect
 	 *
-	 * @param array $hosts
+	 * @param string[] $hosts
 	 * @param string $api_base
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	static function allowed_redirect_hosts( $hosts, $api_base = JETPACK__API_BASE ) {
 		if ( empty( $hosts ) ) {

projects/plugins/jetpack/modules/videopress/utility-functions.php

Doc Comments +1 added lines, -1 removed lines

@@ -308,7 +308,7 @@
  *
  * @since 4.4
  * @param string $title
- * @return int|WP_Error
+ * @return string
  */
 function videopress_create_new_media_item( $title, $guid = null ) {
 	$post = array(

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

Doc Comments +7 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;
@@ -247,6 +250,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $role
+	 */
 	function current_user_can( $role ) {
 		return current_user_can( $role );
 	}
@@ -306,6 +312,7 @@ 
 
 	/**
 	 * Post functions
+	 * @param string $context
 	 */
 
 	function wrap_post( $post, $context ) {

projects/plugins/jetpack/tests/php/core-api/wpcom-endpoints/test-class-wpcom-rest-api-v2-endpoint-external-media.php

Doc Comments +1 added lines, -1 removed lines

@@ -383,7 +383,7 @@
 	 * @param string $filename File name.
 	 * @param string $dir      Temp directory. Dafault empty.
 	 *
-	 * @return string|string[]|null
+	 * @return string
 	 */
 	public function get_temp_name( $filename, $dir = '' ) {
 		if ( empty( $dir ) ) {

projects/plugins/jetpack/tests/php/json-api/test-class.json-api-plugins-endpoints.php

Doc Comments +3 added lines

@@ -161,6 +161,9 @@
 		return 'direct';
 	}
 
+	/**
+	 * @param string $dir
+	 */
 	function rmdir( $dir ) {
 		foreach ( scandir( $dir ) as $file ) {
 			if ( is_dir( $file ) )

projects/plugins/jetpack/tests/php/media/test-class.jetpack-media-extractor.php

Doc Comments +3 added lines

@@ -199,6 +199,9 @@
 		$this->assertEquals( $image_list, $images_extracted );
 	}
 
+	/**
+	 * @return integer
+	 */
 	private function add_test_post() {
 		$post_id = $this->factory->post->create( array(
 			'post_author' => '1046316',

projects/plugins/jetpack/tests/php/media/test-class.jetpack-post-images.php

Doc Comments +1 added lines, -1 removed lines

@@ -410,7 +410,7 @@
 	 *
 	 * @since 9.1.0
 	 *
-	 * @param array $story_media A representative array of the media in the story. Each is one of 'image', 'video', or 'videopress'.
+	 * @param string[] $story_media A representative array of the media in the story. Each is one of 'image', 'video', or 'videopress'.
 	 * @param bool  $wpcom_mode  If true, handles VideoPress videos the way WP.com does. Defaults to false.
 	 * @return array $post_info {
 	 * An array of information about our post.

projects/plugins/jetpack/tests/php/modules/publicize/test_class.publicize.php

Doc Comments +3 added lines

@@ -139,6 +139,9 @@
 		unregister_post_type( 'foo' );
 	}
 
+	/**
+	 * @param boolean $should_have_publicized
+	 */
 	function assertPublicized( $should_have_publicized, $post ) {
 		if ( $should_have_publicized ) {
 			$this->assertEquals( $post->ID, $this->publicized_post_id, 'Is not the same post ID' );

projects/plugins/jetpack/tests/php/sync/server/class.jetpack-sync-test-object-factory.php

Doc Comments +13 added lines

@@ -50,6 +50,9 @@ 
 		'filter'      => 'raw',
 	);
 
+	/**
+	 * @param integer $id
+	 */
 	function post( $id, $props = array() ) {
 
 		$now     = current_time( 'mysql' );
@@ -70,6 +73,9 @@ 
 		return new WP_Post( $post );
 	}
 
+	/**
+	 * @param integer $id
+	 */
 	function comment( $id, $post_id, $props = array() ) {
 		$now     = current_time( 'mysql' );
 		$now_gmt = get_gmt_from_date( $now );
@@ -88,6 +94,10 @@ 
 		return new WP_Comment( $comment );
 	}
 
+	/**
+	 * @param integer $id
+	 * @param string $username
+	 */
 	function user( $id, $username, $props = array() ) {
 		$now = current_time( 'mysql' );
 
@@ -140,6 +150,9 @@ 
 		);
 	}
 
+	/**
+	 * @param integer $id
+	 */
 	function term( $id, $props = array() ) {
 		$term = (object) array_merge(
 			self::$default_term_props,