main ← link-admin-pages-in-site-setting-descriptions
opened 02:10PM - 21 May 26 UTC
Several site setting descriptions reference an admin page by name but leave the …reference as plain text, forcing admins to navigate manually to act on the description's advice. For example, the `auto_silence_first_post_regex` description tells admins to "Use Silence Watched Words instead" without linking to the watched words admin page; `use_admin_ip_allowlist` ends with the textual breadcrumb "(Admin > Logs > Screened Ips)" rather than a link; and `backup_location` mentions "Files settings" with no way to jump there.
Wrap those references in `<a href='%{base_path}/...'>...</a>` so they render as clickable links. The rendering pipeline already supports this: `SiteSettings::LabelFormatter.description` interpolates `%{base_path}` via `I18n.t`, and the admin UI renders the description via `{{trustHTML @description}}` in
`frontend/discourse/admin/components/site-settings/description.gjs`. Existing entries such as `default_locale`, `contact_email`, and `content_security_policy_frame_ancestors` already use the same pattern, so no rendering changes are needed.
The `use_admin_ip_allowlist` entry also drops the trailing "(Admin > Logs > Screened Ips)" breadcrumb, which becomes redundant once the phrase itself is a link.
https://meta.discourse.org/t/403058