Skip to content

OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub

Minor changes to phrasing

Parimal Satyal1a6fbf52e605
diff --git a/lookbook/docs/patterns/04-links.md.erb b/lookbook/docs/patterns/04-links.md.erb
index 857c4c37b35..e0bab8366ac 100644
--- a/lookbook/docs/patterns/04-links.md.erb
+++ b/lookbook/docs/patterns/04-links.md.erb
@@ -1,13 +1,14 @@
-This document outlines our principles for using HTML links within our application. These guidelines align with our [Primer Design System](https://primer.style/product/components/link/accessibility/#accessibility-and-usability-expectations) to ensure consistency, accessibility, and a user-friendly experience.
+This document outlines our principles for using HTML links within OpenProject. These guidelines align with our [Primer Design System](https://primer.style/product/components/link/accessibility/#accessibility-and-usability-expectations) to ensure consistency, accessibility and a user-friendly experience.
# Link Target Behavior
-By default, all links **open in the same browser tab**. This maintains user context and supports a seamless navigation experience.
+By default, all links **open in the same browser tab**. This maintains user context and keeps the navigation seamless. It also gives more agency to the user; if they want to open the link in a new tab, they can choose to do so manually (for example, by Command-clicking on links or right-clicking on them to select the 'Open in a new tab' option).
+# Exceptions
There are **two exceptions** where links may open in a new tab (`target="_blank"`):
-* The link points to an **external platform** (e.g., Nextcloud).
-* Opening the link in the same tab would **break the current user flow**, such as during form completion.
+* The link points to an **external platform** (e.g., Nextcloud)
+* Opening the link in the same tab would **break the current user flow**, such as during form completion
When a link opens in a new tab, the following must be implemented:
@@ -16,7 +17,7 @@ When a link opens in a new tab, the following must be implemented:
# Inline Link Styling
-Links that are part of a paragraph or continuous text must be **underlined**. This ensures they are clearly distinguishable from surrounding text, which is especially important for users with color vision deficiencies.
-For links in form captions and PageHeader descriptions, this is done automatically. Other than that, it has to be done [manually](https://primer.style/view-components/lookbook/inspect/primer/beta/link/default) by setting `underline: true`.
+Links that are part of a paragraph or continuous text must be **underlined**. This ensures they are clearly distinguishable from surrounding text, which is especially important for users with colour vision deficiencies.
+For links in form captions and PageHeader descriptions, this is done automatically. Otherwise, it has to be done [manually](https://primer.style/view-components/lookbook/inspect/primer/beta/link/default) by setting `underline: true`.
<%= embed OpenProject::Common::LinkPreview, :inline %>