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

@@ -10,6 +10,7 @@ import {ForwardRefComponent as PolymorphicForwardRefComponent} from '../utils/po
 type StyledLinkProps = {
   hoverColor?: string
   muted?: boolean
+  /** @deprecated use `inline` to specify the type of link instead */
   underline?: boolean
   // Link inside a text block
   inline?: boolean