jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-19 18:10:59 -05:00
Code Issues Projects Releases Wiki Activity

Update style-guide.md (#54974)

Browse Source 
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
This commit is contained in:
Thom Wong
2025-05-16 09:43:36 +02:00
committed by GitHub
parent 1e75258cc0
commit 59b0a72ca6
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
content/contributing/style-guide-and-content-model/style-guide.md
View File

@@ -1533,11 +1533,12 @@ Format lists and clickable list items in bold. To describe interacting with a li
### Location
Describe a user interface element’s location with standard terms.
* Under or above
* Next to
* Upper-left, upper-right, lower-left, lower-right
* Top of the page, bottom of the page, right side of the page, left side of the page
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.
* [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)
* [Upper-left, upper-right](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/u/upper-left-upper-right)
* [Lower-left, lower-right](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/l/lower-left-lower-right)
* Next to, bottom or top of the page, left or right side of the page
### Panels