Related Issues/PRs

#20616 (comment)

What changes are proposed in this pull request?

Links in Docusaurus admonition blocks (warnings, notes, tips) lacked underlines, making them difficult to distinguish from regular text.

Root cause: The CSS selector .admonition a never matched. Docusaurus CSS Modules hash class names to admonition_xJq3, not .admonition.

Fix: Changed selector to .theme-admonition a (stable, non-hashed Docusaurus class) and added text-decoration: underline;.

-/* Style admonition links to match main content */
-.admonition a {
-  color: var(--ifm-border-color);
+/* Add underline to admonition links for better visibility */
+.theme-admonition a {
+  text-decoration: underline;
 }
 
-.admonition a:hover {
+.theme-admonition a:hover {
   color: var(--ifm-color-emphasis-hover);
 }

Before:

After:

How is this PR tested?

• Manual tests

Verified on /docs/latest/self-hosting/architecture/backend-store/ with built documentation. Links in all admonition types now render with underlines. Links outside admonitions unchanged.

Does this PR require documentation update?

• No. You can skip the rest of this section.

Does this PR require updating the MLflow Skills repository?

• No. You can skip the rest of this section.

Release Notes

Is this a user-facing change?

• Yes. Give a description of this change to be included in the release notes for MLflow users.

Fixed links inside documentation admonition blocks (warnings, notes, tips) lacking underlines, making them easier to identify.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

• area/docs: MLflow documentation pages

How should the PR be classified in the release notes? Choose one:

• rn/bug-fix - A user-facing bug fix worth mentioning in the release notes

Should this PR be included in the next patch release?

• Yes (this PR will be cherry-picked and included in the next patch release)

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.