Revise links reference.

[skip ci]

docs/styles/links/index.md

@@ -9,23 +9,23 @@ Textual supports the concept of inline "links" embedded in text which trigger an
 There are a number of styles which influence the appearance of these links within a widget.
 
 | Property                                              | Description                                                       |
-|-------------------------|-------------------------------------------------------------|
+|-------------------------------------------------------|-------------------------------------------------------------------|
-| [`link-color`](./link_color.md)            | The color of link text.                                     |
+| [`link-color`](./link_color.md)                       | The color of the link text.                                       |
-| [`link-background`](./link_background.md)       | The background color of link text.                          |
+| [`link-background`](./link_background.md)             | The background color of the link text.                            |
-| [`link-style`](./link_style.md)            | The style of link text (e.g. underline).                    |
+| [`link-style`](./link_style.md)                       | The style of the link text (e.g. underline).                      |
-| [`link-hover-color`](./link_hover_color.md)      | The color of link text with the cursor above it.            |
+| [`link-hover-color`](./link_hover_color.md)           | The color of the link text when the cursor is over it.            |
-| [`link-hover-background`](./link_hover_background.md) | The background color of link text with the cursor above it. |
+| [`link-hover-background`](./link_hover_background.md) | The background color of the link text when the cursor is over it. |
-| [`link-hover-style`](./link_hover_style.md)      | The style of link text with the cursor above it.            |
+| [`link-hover-style`](./link_hover_style.md)           | The style of the link text when the cursor is over it.            |
 
 ## Syntax
 
 ```scss
-link-color: <COLOR>;
+link-color: <COLOR> [<PERCENTAGE>];
-link-background: <COLOR>;
+link-background: <COLOR> [<PERCENTAGE>];
-link-style: <TEXT STYLE> ...;
+link-style: <TEXT STYLE>;
-link-hover-color: <COLOR>;
+link-hover-color: <COLOR> [<PERCENTAGE>];
-link-hover-background: <COLOR>;
+link-hover-background: <COLOR> [<PERCENTAGE>];
-link-hover-style: <TEXT STYLE> ...;
+link-hover-style: <TEXT STYLE>;
 ```
 
 --8<-- "docs/styles/snippets/color_css_syntax.md"
@@ -34,8 +34,8 @@ link-hover-style: <TEXT STYLE> ...;
 
 ## Example
 
-In the example below, the first `Static` illustrates default link styling.
+In the example below, the first label illustrates default link styling.
-The second `Static` uses CSS to customize the link color, background, and style.
+The second label uses CSS to customize the link color, background, and style.
 
 === "Output"
 

docs/styles/links/link_background.md

@@ -4,7 +4,7 @@ The `link-background` sets the background color of the link.
 
 !!! note
 
-    `link-background` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-background` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax
 
@@ -18,7 +18,7 @@ link-background: <COLOR> <PERCENTAGE>;
 
 ## Example
 
-The example below shows some links with their color changed.
+The example below shows some links with their background color changed.
 It also shows that `link-background` does not affect hyperlinks.
 
 === "Output"

docs/styles/links/link_color.md

@@ -4,7 +4,7 @@ The `link-color` sets the color of the link text.
 
 !!! note
 
-    `link-style` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-color` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax
 

docs/styles/links/link_hover_background.md

@@ -1,10 +1,10 @@
 # Link-hover-background
 
-The `link-hover-background` sets the background color of the link.
+The `link-hover-background` sets the background color of the link when the mouse cursor is over the link.
 
 !!! note
 
-    `link-hover-background` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-hover-background` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax
 

docs/styles/links/link_hover_color.md

@@ -4,7 +4,7 @@ The `link-hover-color` sets the color of the link text when the mouse cursor is
 
 !!! note
 
-    `link-hover-color` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-hover-color` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax
 

docs/styles/links/link_hover_style.md

@@ -4,7 +4,7 @@ The `link-hover-style` sets the text style for the link text when the mouse curs
 
 !!! note
 
-    `link-hover-style` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-hover-style` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax
 

docs/styles/links/link_style.md

@@ -4,7 +4,7 @@ The `link-style` sets the text style for the link text.
 
 !!! note
 
-    `link-style` only applies to "action links" as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
+    `link-style` only applies to Textual action links as described in the [actions guide](../../guide/actions.md#links) and not to regular hyperlinks.
 
 ## Syntax