Update Link inline prop description and deprecate underline

.changeset/nice-seals-decide.md

@@ -0,0 +1,5 @@
+---
+'@primer/react': minor
+---
+
+Deprecate the `underline` property of the Link component in favor of the new `inline` property to better handle link visibility and accessibility when adjacent to text.

src/Link/Link.docs.json

@@ -15,25 +15,26 @@
       "name": "muted",
       "type": "boolean",
       "defaultValue": "false",
-      "description": "Uses a less prominent shade for Link color, and the default link shade on hover"
+      "description": "Uses a less prominent shade for Link color, and the default link shade on hover."
     },
     {
       "name": "inline",
       "type": "boolean",
       "defaultValue": "false",
-      "description": "Tag link inside a text block"
+      "description": "Set to true for links adjacent to text, underlining them for clear visibility and improved accessibility."
     },
     {
       "name": "underline",
       "type": "boolean",
       "defaultValue": "false",
-      "description": "Adds underline to the Link"
+      "description": "Use `inline` instead.",
+      "deprecated": true
     },
     {
       "name": "hoverColor",
       "type": "string",
       "defaultValue": "",
-      "description": "Color used when hovering over link"
+      "description": "Color used when hovering over the link."
     },
     {
       "name": "ref",

src/Link/Link.tsx

@@ -29,6 +29,7 @@ const StyledLink = styled.a<StyledLinkProps>`
   text-decoration: none;
 
   /* You can add one by setting underline={true} */
+  /** @deprecated */
   text-decoration: ${props => (props.underline ? 'underline' : undefined)};
 
   /* Inline links (inside a text block), however, should have underline based on accessibility setting set in data-attribute */