Docs: various fixes

src/admin-bar-panel.php

@@ -20,6 +20,8 @@ public function __construct() {
 
 	/**
 	 * Renders the debug panel.
+	 *
+	 * @return void
 	 */
 	public function render() {
 		echo '<h2>', \esc_html__( 'Debug Information', 'yoast-test-helper' ), '</h2>';

src/development-mode.php

@@ -87,6 +87,8 @@ public function use_ai_staging_api() {
 	 * Sets a boolean option based on a POST parameter.
 	 *
 	 * @param string $option The option to check and set.
+	 *
+	 * @return void
 	 */
 	private function set_bool_option( $option ) {
 		// The nonce is checked in the handle_submit function.

src/domain-dropdown.php

@@ -88,6 +88,7 @@ public function handle_submit() {
 	 *
 	 * @param string $url     URL of the request about to be made.
 	 * @param array  $headers Headers of the request about to be made.
+	 *
 	 * @return void
 	 */
 	public function modify_myyoast_request( &$url, &$headers ) {
@@ -116,7 +117,8 @@ public function modify_myyoast_request( &$url, &$headers ) {
 	 * @param string $domain  Testing domain to take place in the request.
 	 * @param string $url     URL of request about to be made.
 	 * @param array  $headers Headers of request about to be made.
-	 * @return array [ 'url' => new URL, 'host' => new Host ]
+	 *
+	 * @return array<string, string> Format: [ 'url' => new URL, 'host' => new Host ]
 	 */
 	private function replace_domain( $domain, $url, $headers ) {
 		$host     = '';

src/inline-script.php

@@ -35,6 +35,8 @@ public function add_hooks() {
 
 	/**
 	 * Add an inline script after the specified script.
+	 *
+	 * @return void
 	 */
 	public function add_inline_script() {
 		if ( $this->option->get( 'add_inline_script' ) !== true ) {

src/plugin-version-control.php

@@ -100,6 +100,8 @@ public function handle_submit() {
 	 *
 	 * @param WordPress_Plugin $plugin  Plugin to update a version of.
 	 * @param string           $version Version to update.
+	 *
+	 * @return void
 	 */
 	protected function update_plugin_version( WordPress_Plugin $plugin, $version ) {
 		if ( $this->plugin_version->update_version( $plugin, $version ) ) {

src/plugin.php

@@ -49,6 +49,8 @@ static function ( Integration $integration ) {
 	 * Adds the blocks to the admin page.
 	 *
 	 * @param Admin_Page $admin_page The current admin page.
+	 *
+	 * @return void
 	 */
 	public function admin_page_blocks( Admin_Page $admin_page ) {
 		foreach ( $this->integrations as $integration ) {

src/post-types.php

@@ -123,6 +123,8 @@ public function handle_submit() {
 
 	/**
 	 * Flushes the rewrite rules on the required action.
+	 *
+	 * @return void
 	 */
 	public function flush_rewrite_rules() {
 		\flush_rewrite_rules();
@@ -132,6 +134,8 @@ public function flush_rewrite_rules() {
 	 * Sets a boolean option based on a POST parameter.
 	 *
 	 * @param string $option The option to check and set.
+	 *
+	 * @return void
 	 */
 	private function set_bool_option( $option ) {
 		// The nonce is checked in the handle_submit function.
@@ -142,7 +146,7 @@ private function set_bool_option( $option ) {
 	/**
 	 * Return arguments to use when registering the book post type.
 	 *
-	 * @return array Arguments to use when registering the book post type.
+	 * @return array<string, string|bool|array<string, string>> Arguments to use when registering the book post type.
 	 */
 	private function get_book_args() {
 		return [
@@ -167,7 +171,7 @@ private function get_book_args() {
 	/**
 	 * Get arguments to use when registering the movie post type.
 	 *
-	 * @return array Arguments to use when registering the movie post type.
+	 * @return array<string, string|bool|array<string, string>> Arguments to use when registering the movie post type.
 	 */
 	private function get_movie_args() {
 		return [

src/query-monitor.php

@@ -20,7 +20,7 @@ public function add_hooks() {
 	 *
 	 * @param array $menu Array of menu items.
 	 *
-	 * @return array Array of menu items.
+	 * @return array<string, string> Array of menu items.
 	 */
 	public function add_menu_panel( array $menu ) {
 		$menu['yoast-seo'] = [

src/schema.php

@@ -63,13 +63,17 @@ public function add_hooks() {
 
 	/**
 	 * Registers the schema endpoint if needed.
+	 *
+	 * @return void
 	 */
 	public function init_rewrite() {
 		\add_rewrite_endpoint( 'schema', \EP_ALL );
 	}
 
 	/**
 	 * Send the Yoast SEO Schema.
+	 *
+	 * @return void
 	 */
 	public function send_json_ld() {
 		global $wp_query;

src/taxonomies.php

@@ -25,6 +25,8 @@ public function __construct( Option $option ) {
 
 	/**
 	 * Register the needed hooks.
+	 *
+	 * @return void
 	 */
 	public function add_hooks() {
 		if ( $this->option->get( 'enable_post_types' ) === true ) {
@@ -34,6 +36,8 @@ public function add_hooks() {
 
 	/**
 	 * Registers our post types.
+	 *
+	 * @return void
 	 */
 	public function register_taxonomies() {
 		// Taxonomies for books.
@@ -50,7 +54,7 @@ public function register_taxonomies() {
 	 *
 	 * @param string $slug The slug to set for the taxonomy.
 	 *
-	 * @return array Arguments to use when registering the category taxonomy.
+	 * @return array<string, string|bool|array<string, string>> Arguments to use when registering the category taxonomy.
 	 */
 	private function get_category_args( $slug ) {
 		return [
@@ -73,7 +77,7 @@ private function get_category_args( $slug ) {
 	 *
 	 * @param string $slug The slug to set for the taxonomy.
 	 *
-	 * @return array Arguments to use when registering the genre taxonomy.
+	 * @return array<string, string|bool|array<string, string>> Arguments to use when registering the genre taxonomy.
 	 */
 	private function get_genre_args( $slug ) {
 		return [

src/wordpress-plugins/yoast-seo.php

@@ -274,6 +274,8 @@ private function reset_indexables() {
 	 * Resets the indexing notification such that it is shown again.
 	 *
 	 * @param string $reason The indexing reason why the site needs to be reindexed.
+	 *
+	 * @return void
 	 */
 	protected function reset_indexing_notification( $reason ) {
 		\YoastSEO()->helpers->indexing->set_reason( $reason );