Skip to content

Commit 59b0a72

Browse files
Update style-guide.md (#54974)
Co-authored-by: Ethan Palm <[email protected]>
1 parent 1e75258 commit 59b0a72

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

content/contributing/style-guide-and-content-model/style-guide.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1533,11 +1533,12 @@ Format lists and clickable list items in bold. To describe interacting with a li
15331533

15341534
### Location
15351535

1536-
Describe a user interface element’s location with standard terms.
1537-
* Under or above
1538-
* Next to
1539-
* Upper-left, upper-right, lower-left, lower-right
1540-
* Top of the page, bottom of the page, right side of the page, left side of the page
1536+
As per [WCAG guidance](https://www.w3.org/WAI/WCAG21/Understanding/sensory-characteristics.html), we should describe elements by name and not merely by appearance or location. The Microsoft Style Guide offers specific guidance for directional phrases, with emphasis on their use in documentation.
1537+
1538+
* [Above](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/a/above) or [below](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/below)
1539+
* [Upper-left, upper-right](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/u/upper-left-upper-right)
1540+
* [Lower-left, lower-right](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/l/lower-left-lower-right)
1541+
* Next to, bottom or top of the page, left or right side of the page
15411542

15421543
### Panels
15431544

0 commit comments

Comments
 (0)