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
Ruby agile-developmentangularbcfboardsbug-trackerganttgantt-chartifcissue-trackerjira-alternativekanbanopenprojectproduct-managementproject-managementproject-planningroadmaprubyscrumtimelineworkflows
Minor changes to phrasing
Parimal Satyal1a6fbf52e605
diff --git a/lookbook/docs/patterns/04-links.md.erb b/lookbook/docs/patterns/04-links.md.erbindex 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).+# ExceptionsThere 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 completionWhen 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 %>