From b04edb1fcc0f4959dafd8b3c75e3bb96a6d2a0ef Mon Sep 17 00:00:00 2001
From: Joe Dolson <design@joedolson.com>
Date: Thu, 30 Jul 2026 14:16:37 -0500
Subject: [PATCH 1/2] Update labelling on reading and discussion

Eliminates problems with plural/singular and fixes labeling for screen readers.
---
 src/wp-admin/options-discussion.php | 13 ++++---------
 src/wp-admin/options-reading.php    |  8 ++++----
 2 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/src/wp-admin/options-discussion.php b/src/wp-admin/options-discussion.php
index f8e4d5040f4e7..9ee39a3f27965 100644
--- a/src/wp-admin/options-discussion.php
+++ b/src/wp-admin/options-discussion.php
@@ -182,15 +182,10 @@
 <tr>
 <th scope="row"><?php echo $comment_moderation_title; ?></th>
 <td><fieldset><legend class="screen-reader-text"><span><?php echo $comment_moderation_title; ?></span></legend>
-<p><label for="comment_max_links">
-<?php
-printf(
-	/* translators: %s: Number of links. */
-	__( 'Hold a comment in the queue if it contains %s or more links. (A common characteristic of comment spam is a large number of hyperlinks.)' ),
-	'<input name="comment_max_links" type="number" step="1" min="0" id="comment_max_links" value="' . esc_attr( get_option( 'comment_max_links' ) ) . '" class="small-text" />'
-);
-?>
-</label></p>
+<p><label for="comment_max_links"><?php _e( 'Number of links to allow in a comment before holding for moderation.' ); ?></label>
+<input name="comment_max_links" type="number" step="1" min="0" id="comment_max_links" value="<?php echo esc_attr( get_option( 'comment_max_links' ) ); ?>" class="small-text" aria-describedby="comment_links_moderation_desc" />
+<span id="comment_links_moderation_desc"><?php _e( '(A common characteristic of comment spam is a large number of hyperlinks.)' ); ?></span>
+</p>
 
 <p><label for="moderation_keys"><?php _e( 'When a comment contains any of these words in its content, author name, URL, email, IP address, or browser&#8217;s user agent string, it will be held in the <a href="edit-comments.php?comment_status=moderated">moderation queue</a>. One word or IP address per line. It will match inside words, so &#8220;press&#8221; will match &#8220;WordPress&#8221;.' ); ?></label></p>
 <p>
diff --git a/src/wp-admin/options-reading.php b/src/wp-admin/options-reading.php
index 31facac7edcca..68d0496f9e307 100644
--- a/src/wp-admin/options-reading.php
+++ b/src/wp-admin/options-reading.php
@@ -175,14 +175,14 @@
 </tr>
 <?php endif; ?>
 <tr>
-<th scope="row"><label for="posts_per_page"><?php _e( 'Blog pages show at most' ); ?></label></th>
+<th scope="row"><label for="posts_per_page"><?php _e( 'Number of recent posts shown on blog pages' ); ?></label></th>
 <td>
-<input name="posts_per_page" type="number" step="1" min="1" id="posts_per_page" value="<?php form_option( 'posts_per_page' ); ?>" class="small-text" /> <?php _e( 'posts' ); ?>
+<input name="posts_per_page" type="number" step="1" min="1" id="posts_per_page" value="<?php form_option( 'posts_per_page' ); ?>" class="small-text" />
 </td>
 </tr>
 <tr>
-<th scope="row"><label for="posts_per_rss"><?php _e( 'Syndication feeds show the most recent' ); ?></label></th>
-<td><input name="posts_per_rss" type="number" step="1" min="1" id="posts_per_rss" value="<?php form_option( 'posts_per_rss' ); ?>" class="small-text" /> <?php _e( 'items' ); ?></td>
+<th scope="row"><label for="posts_per_rss"><?php _e( 'Number of recent items shown in syndication feeds' ); ?></label></th>
+<td><input name="posts_per_rss" type="number" step="1" min="1" id="posts_per_rss" value="<?php form_option( 'posts_per_rss' ); ?>" class="small-text" /></td>
 </tr>
 
 <?php $rss_use_excerpt_title = __( 'For each post in a feed, include' ); ?>

From 4666859b4e55682f8e77abeffc6b60f7244f438d Mon Sep 17 00:00:00 2001
From: Joe Dolson <design@joedolson.com>
Date: Thu, 30 Jul 2026 14:38:05 -0500
Subject: [PATCH 2/2] Change to 'archive pages'`

This is what Gary suggested in his original patch, and I like it better.
---
 src/wp-admin/options-reading.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/wp-admin/options-reading.php b/src/wp-admin/options-reading.php
index 68d0496f9e307..d52d51bbe3ae4 100644
--- a/src/wp-admin/options-reading.php
+++ b/src/wp-admin/options-reading.php
@@ -175,7 +175,7 @@
 </tr>
 <?php endif; ?>
 <tr>
-<th scope="row"><label for="posts_per_page"><?php _e( 'Number of recent posts shown on blog pages' ); ?></label></th>
+<th scope="row"><label for="posts_per_page"><?php _e( 'Number of recent posts shown on archive pages' ); ?></label></th>
 <td>
 <input name="posts_per_page" type="number" step="1" min="1" id="posts_per_page" value="<?php form_option( 'posts_per_page' ); ?>" class="small-text" />
 </td>