Merge pull request #41 from Eddy3D-Dev/palette/improve-link-text-accessibility-3781203515413581590

🎨 Palette: Improve link text accessibility

Author: kastnerp

.Jules/palette.md

@@ -38,3 +38,7 @@
 ## 2025-03-29 - [Descriptive Link Text]
 **Learning:** Using `aria-label` to fix generic link text (like "Learn more") is an anti-pattern when we can just make the visible text itself descriptive. Descriptive visible text helps all users, not just screen reader users, and avoids WCAG 2.5.3 (Label in Name) violations where the label might not contain the visible text perfectly.
 **Action:** Always prefer updating the visible text of a link to be descriptive rather than adding an `aria-label` to generic text.
+
+## 2026-03-25 - Avoid "these instructions" anti-pattern
+**Learning:** Using link text like "these instructions for..." creates a poor experience for screen reader users and those navigating out of context. The link text should be fully self-descriptive without needing surrounding context.
+**Action:** Always prefer updating the visible text of the link to be descriptive and human-readable (e.g., change `see [these instructions for matching MPI DLL files](...)` to `see the [CFD Online instructions for matching MPI DLL files](...)`).

docs/outdoor/index.md

@@ -25,7 +25,7 @@ If you would like to use the *experimental* MRT component, please install [Radia
 
 ### Parallel computation
 
-There is currently an issue with Microsoft’s and BlueCFD’s MPI dll which is why a run with multiple CPUs might fail. You need both dlls to be the same file, see [these instructions for matching MPI DLL files](https://www.cfd-online.com/Forums/openfoam-installation/200437-bluecfd-core-2016-user-compiled-solvers-not-running-parallel.html#post687582) on how to ensure that.
+There is currently an issue with Microsoft’s and BlueCFD’s MPI dll which is why a run with multiple CPUs might fail. You need both dlls to be the same file, see the [CFD Online instructions for matching MPI DLL files](https://www.cfd-online.com/Forums/openfoam-installation/200437-bluecfd-core-2016-user-compiled-solvers-not-running-parallel.html#post687582) to ensure that both DLLs are the same file.
 
 ### Simple workflows