tweak the popover instructions

Author: aristath

classes/suggested-tasks/providers/class-fewer-tags.php

@@ -173,7 +173,7 @@ public function print_popover_instructions() {
 		echo '<p>';
 		\printf(
 			// translators: %1$s is the number of tags, %2$s is the number of published posts.
-			\esc_html__( 'We detected that you have %1$s tags and %2$s published posts. Consider installing the "Fewer Tags" plugin.', 'progress-planner' ),
+			\esc_html__( 'Your site has %1$s tags across %2$s published posts. Having too many tags can dilute your content organization and hurt SEO. The "Fewer Tags" plugin helps you consolidate similar tags.', 'progress-planner' ),
 			(int) $this->post_tag_count_data_collector->collect(),
 			(int) $this->published_post_count_data_collector->collect(),
 		);

classes/suggested-tasks/providers/class-permalink-structure.php

@@ -119,7 +119,7 @@ public function should_add_task() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'On install, WordPress sets the permalink structure to a format that is not SEO-friendly. We recommend changing it.', 'progress-planner' );
+		\esc_html_e( 'By default, WordPress uses date-based URLs (e.g., /2025/01/21/post-name/) which can make your content seem outdated. SEO-friendly URLs help search engines and visitors better understand your content.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/class-remove-terms-without-posts.php

@@ -366,7 +366,7 @@ public function add_task_actions( $data = [], $actions = [] ) {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Deleting this empty term will help keep your site organized. This action cannot be undone.', 'progress-planner' );
+		\esc_html_e( 'This term has no posts assigned to it. Removing unused terms keeps your site organized, improves navigation, and prevents empty archive pages. Note: This action cannot be undone.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/class-rename-uncategorized-category.php

@@ -108,7 +108,7 @@ public function update_uncategorized_category_cache() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'The Uncategorized category is used for posts that don\'t have a category. We recommend renaming it to something that fits your site better.', 'progress-planner' );
+		\esc_html_e( 'WordPress assigns posts to "Uncategorized" by default if no category is selected. Renaming this to something meaningful (like "General" or your main topic) creates a better user experience and looks more professional.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/class-search-engine-visibility.php

@@ -102,7 +102,7 @@ public function should_add_task() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Your site is not currently visible to search engines. Consider allowing search engines to index your site.', 'progress-planner' );
+		\esc_html_e( 'Your site is currently hidden from search engines like Google and Bing. This setting is useful during development, but prevents people from finding your content through search. If your site is ready to go live, you should enable search engine visibility.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/class-update-term-description.php

@@ -358,7 +358,7 @@ public function add_task_actions( $data = [], $actions = [] ) {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Adding a description to your term helps search engines and visitors understand what content to expect.', 'progress-planner' );
+		\esc_html_e( 'Term descriptions appear on category and tag archive pages, helping visitors understand what to expect. They also provide important context for search engines, which can improve your SEO.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/integrations/yoast/class-archive-author.php

@@ -115,7 +115,7 @@ public function is_task_relevant() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Yoast SEO can disable the author archive when you have only one author, as it is the same as the homepage.', 'progress-planner' );
+		\esc_html_e( 'When your site has only one author, the author archive is redundant and creates duplicate content issues. Disabling it prevents search engines from indexing the same content multiple times.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/integrations/yoast/class-archive-date.php

@@ -102,7 +102,7 @@ public function is_task_relevant() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Yoast SEO can disable the date archive, which is really only useful for news sites and blogs.', 'progress-planner' );
+		\esc_html_e( 'Date archives are primarily useful for news sites and time-sensitive content. For most websites, they add unnecessary URLs that can dilute your SEO. Disable them unless your content is date-specific.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/integrations/yoast/class-archive-format.php

@@ -115,7 +115,7 @@ public function is_task_relevant() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'WordPress creates an archive for each post format. This is not useful and can be disabled in the Yoast SEO settings.', 'progress-planner' );
+		\esc_html_e( 'WordPress creates separate archives for each post format (standard, aside, gallery, etc.). Most sites don\'t use post formats, making these archives unnecessary. Disabling them reduces crawl waste and potential duplicate content.', 'progress-planner' );
 		echo '</p>';
 	}
 

classes/suggested-tasks/providers/integrations/yoast/class-crawl-settings-emoji-scripts.php

@@ -94,7 +94,7 @@ public function should_add_task() {
 	 */
 	public function print_popover_instructions() {
 		echo '<p>';
-		\esc_html_e( 'Remove JavaScript used for converting emoji characters in older browsers.', 'progress-planner' );
+		\esc_html_e( 'WordPress loads extra JavaScript to support emojis in older browsers. Modern browsers (and most of your visitors) don\'t need this, so removing it improves your site\'s loading speed.', 'progress-planner' );
 		echo '</p>';
 	}