The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with stop responding.)
|
Close the Alarms app.
Close Excel.
Close the blade.
Close the Users + groups blade.
Save and close the document.
Closing Excel also closes all open worksheets.
|
| **Leave** | Websites and webpages | Select **Submit** to complete the survey and leave this page. |
| **Go to** |
Opening a menu.
Going to a tab or another particular place in the UI.
Going to a website or webpage.
It's OK to use On theXXXtab if the instruction is brief and continues immediately.
|
Go to Search , enter the word settings, and then select Settings.
Go to File, and then select Close.
On the ribbon, go to the Design tab.
Go to the Deploy tab. In the Configuration list …
On the Deploy tab, in the Configuration list …
Go to Example.com to register.
|
-| **Select** | Instructing the customer to select a specific item, including:
Selecting an option, such as a button.
Selecting a check box.
Selecting a value from a list box.
Selecting link text to go to a link.
Selecting an item on a menu or shortcut menu.
Selecting an item from a gallery.
Selecting keys and keyboard shortcuts. (Document keyboard shortcuts only if they're the most likely way the customer will accomplish a task or as an alternative input method, usually in a separate keyboard shortcuts article.)
|
Select the Modify button.
For Alignment, select Left.
Select the text, open the shortcut menu, and then select Font.
Select Open in new tab.
Select the LinkName link.
Select **F5**.
Select **Shift+Enter**.
Select **Ctrl+Alt+Delete**.
|
+| **Select** | Instructing the customer to select a specific item, including:
Selecting an option, such as a button.
Selecting a checkbox.
Selecting a value from a list box.
Selecting link text to go to a link.
Selecting an item on a menu or shortcut menu.
Selecting an item from a gallery.
Selecting keys and keyboard shortcuts. (Document keyboard shortcuts only if they're the most likely way the customer will accomplish a task or as an alternative input method, usually in a separate keyboard shortcuts article.)
|
Select the Modify button.
For Alignment, select Left.
Select the text, open the shortcut menu, and then select Font.
Select Open in new tab.
Select the LinkName link.
Select **F5**.
Select **Shift+Enter**.
Select **Ctrl+Alt+Delete**.
|
| **Select and hold, select and hold (or right-click)** | Use to describe pressing and holding an element in the UI. It's OK to use *right-click* with *select and hold* when the instruction isn't specific to touch devices. |
To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.
Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.
Select and hold (or right-click) the **Start** button, and then select **Device Manager**.
|
| **>** | Use a greater-than symbol (>) to separate sequential steps.
Only use this approach when there's a clear and obvious path through the UI and the selection method is the same for each step. For example, don't mix things that require opening, selecting, and choosing.
Don't bold the greater-than symbol. Include a space before and after the symbol. | Select **Accounts > Other accounts > Add an account**. |
-| **Clear** | Clearing the selection from a check box. | Clear the **Header row** check box. |
+| **Clear** | Clearing the selection from a checkbox. | Clear the **Header row** checkbox. |
| **Choose** | Choosing an option, based on the customer's preference or desired outcome. | On the **Font** tab, choose the effects you want. |
| **Switch, turn on, turn off** | Turning a toggle key or toggle switch on or off. |
Use the **Caps lock** key to switch from typing capital letters to typing lowercase letters.
To switch between Normal, Outline, and Slide Sorter views, use the buttons on the View tab.
To make text and apps easier to see, turn on the toggle under Turn on high contrast.
To keep all applied filters, turn on the Pass all filters toggle.
|
| **Enter** | Instructing the customer to type or otherwise insert a value, or to type or select a value in a combo box. |
In the search box, enter…
In the **Tab stop position** box, enter the location where you want to set the new tab.
In the **Deployment script name** box, enter a name for this script.
|
From 53eafd8d40a5367b35673435ceded38a922b0052 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:15:59 +0200
Subject: [PATCH 081/486] Update cancel-canceled-canceling-cancellation.md
---
.../c/cancel-canceled-canceling-cancellation.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md b/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
index 13ef908f..7233ddbb 100644
--- a/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
+++ b/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
@@ -2,14 +2,14 @@
title: cancel, canceled, canceling, cancellation - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
# cancel, canceled, canceling, cancellation
-Use *cancel the selection* instead of *deselect* or *unmark*. Use *clear* to refer to check boxes.
+Use *cancel the selection* instead of *deselect* or *unmark*. Use *clear* to refer to checkboxes.
Use *cancel* to describe ending code requests and processes before they're complete.
From 8f27e98940392e82cd68a524dfb14c6e080e6187 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:17:07 +0200
Subject: [PATCH 082/486] Update control.md
---
styleguide/a-z-word-list-term-collections/c/control.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/c/control.md b/styleguide/a-z-word-list-term-collections/c/control.md
index 1c735077..a01048c0 100644
--- a/styleguide/a-z-word-list-term-collections/c/control.md
+++ b/styleguide/a-z-word-list-term-collections/c/control.md
@@ -2,14 +2,14 @@
title: control - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
# control
-In content for a general audience, don't use *control* to refer to a UI element such as a text box, check box, or list box. It's OK to use *control* to refer to adding a user-defined control in a program.
+In content for a general audience, don't use *control* to refer to a UI element such as a text box, checkbox, or list box. It's OK to use *control* to refer to adding a user-defined control in a program.
In other contexts, it's OK to use *control*.
From 1b78aab1a88b99383c24fa5026623e6506df8177 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:17:46 +0200
Subject: [PATCH 083/486] Update deselect.md
---
styleguide/a-z-word-list-term-collections/d/deselect.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/deselect.md b/styleguide/a-z-word-list-term-collections/d/deselect.md
index 23a41ea4..0a92f840 100644
--- a/styleguide/a-z-word-list-term-collections/d/deselect.md
+++ b/styleguide/a-z-word-list-term-collections/d/deselect.md
@@ -2,13 +2,13 @@
title: deselect - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
# deselect
-Don't use. Use *clear* for check boxes and *cancel the selection* for other UI elements.
+Don't use. Use *clear* for checkboxes and *cancel the selection* for other UI elements.
**See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md)
From a76a2bd76821e468cac963d1ba48aa1b0d114b1b Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:18:29 +0200
Subject: [PATCH 084/486] Update dimmed.md
---
styleguide/a-z-word-list-term-collections/d/dimmed.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/dimmed.md b/styleguide/a-z-word-list-term-collections/d/dimmed.md
index 60559f98..999bea8c 100644
--- a/styleguide/a-z-word-list-term-collections/d/dimmed.md
+++ b/styleguide/a-z-word-list-term-collections/d/dimmed.md
@@ -2,7 +2,7 @@
title: dimmed - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -11,7 +11,7 @@ ms.prod: non-product-specific
Most of the time, talk about the actions that customers should take rather than describing UI.
-Don’t use to describe commands or options that are in an unusable state—use *not available* or *isn’t available* instead. It’s OK to use *appears dimmed* if you must describe their appearance. Use *shaded* to describe the appearance of check boxes that represent a mixture of settings.
+Don’t use to describe commands or options that are in an unusable state—use *not available* or *isn’t available* instead. It’s OK to use *appears dimmed* if you must describe their appearance. Use *shaded* to describe the appearance of checkboxes that represent a mixture of settings.
**Examples**
The command isn't available until you select text.
From 5025ef3658926664a9714d99f342aca8a6d2f7b1 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:45:39 +0200
Subject: [PATCH 085/486] Update turn-on-turn-off.md
---
.../a-z-word-list-term-collections/t/turn-on-turn-off.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
index 9b4f3763..e37d0c8f 100644
--- a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
+++ b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
@@ -2,7 +2,7 @@
title: turn on, turn off - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -11,7 +11,7 @@ ms.prod: non-product-specific
Use instead of *power on/power off, start/stop,* or *switch on/switch off* to mean turning the device on and off.
-Don't use to refer to selecting or clearing check boxes in instructions. Use *select* and *clear* instead. It's OK to use *turn on/turn off* to refer to webpage options and toggles.
+Don't use to refer to selecting or clearing checkboxes in instructions. Use *select* and *clear* instead. It's OK to use *turn on/turn off* to refer to webpage options and toggles.
Use *turned on* and *turned off* instead of *enabled* and *disabled* to refer to commands and features that can be hidden or deactivated.
From 5e0bc3644beb60139f582ed20669c57ee8d5fad8 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:46:31 +0200
Subject: [PATCH 086/486] Update gray-grayed-out.md
---
.../a-z-word-list-term-collections/g/gray-grayed-out.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md b/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
index 574be852..254badd0 100644
--- a/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
+++ b/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
@@ -2,7 +2,7 @@
title: gray, grayed out - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -11,7 +11,7 @@ ms.prod: non-product-specific
Most of the time, talk about the actions that customers should take.
-Don’t use *gray* or *grayed out* to describe commands or options that are in an unusable state—use *not available* or *isn’t available* instead. Use *appears dimmed* if you must describe their appearance. Use *shaded* to describe the appearance of check boxes that represent a mixture of settings.
+Don’t use *gray* or *grayed out* to describe commands or options that are in an unusable state—use *not available* or *isn’t available* instead. Use *appears dimmed* if you must describe their appearance. Use *shaded* to describe the appearance of checkboxes that represent a mixture of settings.
**Examples**
The command isn’t available until you select text.
From 941858e832c3790dc4e273266b9ce7e7f5db30b5 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:47:37 +0200
Subject: [PATCH 087/486] Update shaded.md
---
styleguide/a-z-word-list-term-collections/s/shaded.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/shaded.md b/styleguide/a-z-word-list-term-collections/s/shaded.md
index 3dba8775..040294bc 100644
--- a/styleguide/a-z-word-list-term-collections/s/shaded.md
+++ b/styleguide/a-z-word-list-term-collections/s/shaded.md
@@ -2,7 +2,7 @@
title: shaded - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -13,7 +13,7 @@ Most of the time, talk about the actions that customers should take.
Don’t use to describe commands or options that are in an unusable state—use *not available* or *isn’t available* instead. If you must describe their appearance, use *appears dimmed.*
-It’s OK to use *shaded* to describe the appearance of check boxes that represent a mixture of settings.
+It’s OK to use *shaded* to describe the appearance of checkboxes that represent a mixture of settings.
**Examples**
The command isn’t available until you select text.
From ca450857862942afa4a4c5b8cb77bdf51f1e3603 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:48:21 +0200
Subject: [PATCH 088/486] Update icon.md
---
styleguide/a-z-word-list-term-collections/i/icon.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/i/icon.md b/styleguide/a-z-word-list-term-collections/i/icon.md
index 1bd77c65..94e6be58 100644
--- a/styleguide/a-z-word-list-term-collections/i/icon.md
+++ b/styleguide/a-z-word-list-term-collections/i/icon.md
@@ -2,7 +2,7 @@
title: icon - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 07/31/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -17,7 +17,7 @@ document, or app.
Don't use *icon*
to describe graphical dialog box options or options that appear on
ribbons, toolbars, toolboxes, or other areas of a window. For options
-that have graphics rather than text labels, use the most descriptive term available, such as *button, box,* or *check box*. To refer to the graphic itself, if there's no other identifying label, use *symbol,* as in *warning symbol.*
+that have graphics rather than text labels, use the most descriptive term available, such as *button, box,* or *checkbox*. To refer to the graphic itself, if there's no other identifying label, use *symbol,* as in *warning symbol.*
When referring to an icon, use bold formatting for the icon name. In instructions, use the name of the icon and its image, but don't use the word *icon*.
**Example** Select **Xbox** .
From 70ba8c16a27a63fc7efd30a1d15a8af42cd3c891 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:50:43 +0200
Subject: [PATCH 089/486] Update person.md
---
styleguide/grammar/person.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index 0336df0c..ca53a9df 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -2,7 +2,7 @@
title: Person - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 09/13/2019
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -24,7 +24,7 @@ You can set advanced options later if you need them.
Use first person (usually *I* or *me*) only when you need to write from the point of view of the customer.
**Example**
-Alert me when a new Bluetooth device tries to connect to my computer. (check box text)
+Alert me when a new Bluetooth device tries to connect to my computer. (checkbox text)
**Exception** Cortana is a persona, so the use of *I* is appropriate.
From 6301c543f7b1bc9310587409079866990b4f2a52 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 12:58:06 +0200
Subject: [PATCH 090/486] Update capitalization.md
---
styleguide/capitalization.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/capitalization.md b/styleguide/capitalization.md
index e484099d..473c7bd5 100644
--- a/styleguide/capitalization.md
+++ b/styleguide/capitalization.md
@@ -2,7 +2,7 @@
title: Capitalization - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 09/6/2019
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -18,7 +18,7 @@ Follow these guidelines in Microsoft content:
- Use sentence-style capitalization most of the time. That means:
- Capitalize the first word of a sentence, heading, title, UI label (such as
- the name of a button or check box), or standalone phrase.
+ the name of a button or checkbox), or standalone phrase.
- Capitalize proper nouns. To learn more about proper nouns, see [Nouns and pronouns](~/grammar/nouns-pronouns.md).
- Use lowercase for everything else.
From dfdbd68980d1f27e05a6ecf5ed65c66b1a547b0c Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 13:00:54 +0200
Subject: [PATCH 091/486] Update writing-tips.md
---
styleguide/global-communications/writing-tips.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/global-communications/writing-tips.md b/styleguide/global-communications/writing-tips.md
index c8c91b02..ee89b55e 100644
--- a/styleguide/global-communications/writing-tips.md
+++ b/styleguide/global-communications/writing-tips.md
@@ -2,7 +2,7 @@
title: Writing tips - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 04/30/2018
+ms.date: 04/02/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -31,7 +31,7 @@ it into multiple sentences.
**Include *that* and *who*.** They help to clarify the sentence structure.
**Examples**
Inspect the database to verify that all tables, data, and relationships were correctly migrated.
-Select the check box of each folder that you want to sync with your desktop.
+Select the checkbox of each folder that you want to sync with your desktop.
**Include articles,** such as *the.* Articles help readers and translation software identify the nouns and modifiers in a sentence.
**Examples**
From aa104a311ea89bd9f0c1d773e95bf492483315a2 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 2 Apr 2021 13:07:08 +0200
Subject: [PATCH 092/486] Update pull-down.md
---
styleguide/a-z-word-list-term-collections/p/pull-down.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/p/pull-down.md b/styleguide/a-z-word-list-term-collections/p/pull-down.md
index 64a424e6..fd9218cd 100644
--- a/styleguide/a-z-word-list-term-collections/p/pull-down.md
+++ b/styleguide/a-z-word-list-term-collections/p/pull-down.md
@@ -2,7 +2,7 @@
title: pull-down - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 05/17/2018
+ms.date: 04/01/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -19,6 +19,6 @@ In the **Background** list, select **Solid color**.
Go to **Tools**, and select **Change language**.
**See also**
-[drop-down](~/a-z-word-list-term-collections/d/drop-down.md)
+[dropdown](~/a-z-word-list-term-collections/d/dropdown.md)
[Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md)
[Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md)
From 0c29ca6fddf44f0ce0dafa94cdc544459ea45b49 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 15:24:56 +0200
Subject: [PATCH 093/486] Create dark mode.md
New topic
---
.../d/dark mode.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/d/dark mode.md
diff --git a/styleguide/a-z-word-list-term-collections/d/dark mode.md b/styleguide/a-z-word-list-term-collections/d/dark mode.md
new file mode 100644
index 00000000..ef983505
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/d/dark mode.md
@@ -0,0 +1,19 @@
+---
+title: dark mode - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 04/30/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# dark mode
+
+Lowercase, two words.
+
+*Dark mode* is a display setting that changes the interface from a bright background color to a darker color. This setting can be easier on the eyes in lower-light environments and for people who prefer interfaces that aren’t as bright.
+
+**Examples**
+Use *dark mode* to reduce eye strain.
+
+Turn on *dark mode* automatically at sunset.
From 61099a526845fed92749fab947eeca0006b9b968 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 15:40:19 +0200
Subject: [PATCH 094/486] Create invite.md
New topic
---
.../a-z-word-list-term-collections/i/invite.md | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/i/invite.md
diff --git a/styleguide/a-z-word-list-term-collections/i/invite.md b/styleguide/a-z-word-list-term-collections/i/invite.md
new file mode 100644
index 00000000..e8e1347c
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/i/invite.md
@@ -0,0 +1,18 @@
+---
+title: invite - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 04/30/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# invite
+*Invite* can be used as a noun or a verb.
+
+An *invite* is used to request an individual’s virtual participation in a meeting, organization, or an event.
+
+**Examples**
+The working group will *invite* other stakeholders to weigh in on the proposal.
+
+Send an *invite* that includes dial-in conferencing.
From 8e655a52cd8bfc17a09086298297a83f1f4ae9f1 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 15:41:48 +0200
Subject: [PATCH 095/486] Create smb.md
---
styleguide/a-z-word-list-term-collections/s/smb.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/s/smb.md
diff --git a/styleguide/a-z-word-list-term-collections/s/smb.md b/styleguide/a-z-word-list-term-collections/s/smb.md
new file mode 100644
index 00000000..5d423496
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/s/smb.md
@@ -0,0 +1,12 @@
+---
+title: SMB - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 04/30/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# SMB
+
+Avoid using the acronym *SMB*. Use *small or medium-sized business* instead.
From 9f3159d955400f67935ea0975d55f0e4d0568792 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 15:53:48 +0200
Subject: [PATCH 096/486] Update TOC.md
---
styleguide/TOC.md | 3 +++
1 file changed, 3 insertions(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index cf5e06ea..481e7823 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -194,6 +194,7 @@
### [cut, cut-and-paste](a-z-word-list-term-collections/c/cut-and-paste.md)
### [cyber-](a-z-word-list-term-collections/c/cyber.md)
## D
+### [dark mode](a-z-word-list-term-collections/term-collections/d/dark-mode.md)
### [data, datum](a-z-word-list-term-collections/d/data-datum.md)
### [data binding](a-z-word-list-term-collections/d/data-binding.md)
### [data record](a-z-word-list-term-collections/d/data-record.md)
@@ -424,6 +425,7 @@
### [Internet of Things (IoT)](a-z-word-list-term-collections/i/internet-of-things-iot.md)
### [internet service provider (ISP)](a-z-word-list-term-collections/i/internet-service-provider.md)
### [invalid, not valid](a-z-word-list-term-collections/i/invalid-not-valid.md)
+### [invite](a-z-word-list-term-collections/term-collections/i/invite.md)
### [invoke](a-z-word-list-term-collections/i/invoke.md)
### [IP address](a-z-word-list-term-collections/i/ip-address.md)
### [issue](a-z-word-list-term-collections/i/issue.md)
@@ -732,6 +734,7 @@
### [small caps](a-z-word-list-term-collections/s/small-caps.md)
### [smart card, Smart Card](a-z-word-list-term-collections/s/smart-card.md)
### [smartphone](a-z-word-list-term-collections/s/smartphone.md)
+### [smb](a-z-word-list-term-collections/term-collections/s/smb.md)
### [snap-in](a-z-word-list-term-collections/s/snap-in.md)
### [social chatbot](a-z-word-list-term-collections/s/social-chatbot.md)
### [soft copy](a-z-word-list-term-collections/s/soft-copy.md)
From 2593d800c9247f4761eaed877f2a9eb6d47f9d71 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 15:57:02 +0200
Subject: [PATCH 097/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index f9561598..3a957778 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -2,7 +2,7 @@
title: What's new? - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 03/31/2021
+ms.date: 04/30/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -14,6 +14,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| April 30, 2021 | [invite](~/a-z-word-list-term-collections/term-collections/i/invite.md) | New topic.
+| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/term-collections/d/dark-mode.md) | New topic.
+| April 30, 2021 | [smb](~/a-z-word-list-term-collections/term-collections/s/smb.md) | New topic.
| March 31, 2021 | [bits and bytes](~/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md) | Updated guidance on when to abbreviate certain terms.
| March 31, 2021 | [dialog box, dialog, dialogue](~/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md) | Updated guidance on use.
| March 29, 2021 | [check, checkbox, check mark](~/a-z-word-list-term-collections/c/check-checkbox-check-mark.md) | Updated guidance on use.
From 6c2c61f50a687ebc7f6fbab00b1fd9feaa3187eb Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 16:40:51 +0200
Subject: [PATCH 098/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index ee59b7ac..67ff9fd8 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -2,7 +2,7 @@
title: Don't use common words in new ways - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/30/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -35,7 +35,6 @@ Most people know the common definition of words—usually the one that appears f
|**Use this**|**Not this**|
|--|--|
- |open an invitation|open an invite|
|affect performance|impact performance|
|download the paper|get the download|
|respond to the request|respond to the ask|
From 5fa9f7a39967e99684ce1ab3f333a702910a8046 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 16:51:38 +0200
Subject: [PATCH 099/486] Update TOC.md
---
styleguide/TOC.md | 1 -
1 file changed, 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 481e7823..3d8d0a64 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -940,7 +940,6 @@
## [Formatting text in instructions](procedures-instructions/formatting-text-in-instructions.md)
## [Illustrating network traffic flows](procedures-instructions/illustrating-network-traffic-flows.md)
# [Punctuation](punctuation/index.md)
-## [@mentions](punctuation/@mention.md)
## [Formatting punctuation](punctuation/formatting-punctuation.md)
## [Apostrophes](punctuation/apostrophes.md)
## [Colons](punctuation/colons.md)
From e908cda5bab4c03b286f83e787d21f22767c93ff Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 17:08:58 +0200
Subject: [PATCH 100/486] Update TOC.md
---
styleguide/TOC.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 3d8d0a64..350224db 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -194,7 +194,7 @@
### [cut, cut-and-paste](a-z-word-list-term-collections/c/cut-and-paste.md)
### [cyber-](a-z-word-list-term-collections/c/cyber.md)
## D
-### [dark mode](a-z-word-list-term-collections/term-collections/d/dark-mode.md)
+### [dark mode](a-z-word-list-term-collections/d/dark-mode.md)
### [data, datum](a-z-word-list-term-collections/d/data-datum.md)
### [data binding](a-z-word-list-term-collections/d/data-binding.md)
### [data record](a-z-word-list-term-collections/d/data-record.md)
@@ -425,7 +425,7 @@
### [Internet of Things (IoT)](a-z-word-list-term-collections/i/internet-of-things-iot.md)
### [internet service provider (ISP)](a-z-word-list-term-collections/i/internet-service-provider.md)
### [invalid, not valid](a-z-word-list-term-collections/i/invalid-not-valid.md)
-### [invite](a-z-word-list-term-collections/term-collections/i/invite.md)
+### [invite](a-z-word-list-term-collections/i/invite.md)
### [invoke](a-z-word-list-term-collections/i/invoke.md)
### [IP address](a-z-word-list-term-collections/i/ip-address.md)
### [issue](a-z-word-list-term-collections/i/issue.md)
@@ -734,7 +734,7 @@
### [small caps](a-z-word-list-term-collections/s/small-caps.md)
### [smart card, Smart Card](a-z-word-list-term-collections/s/smart-card.md)
### [smartphone](a-z-word-list-term-collections/s/smartphone.md)
-### [smb](a-z-word-list-term-collections/term-collections/s/smb.md)
+### [smb](a-z-word-list-term-collections/s/smb.md)
### [snap-in](a-z-word-list-term-collections/s/snap-in.md)
### [social chatbot](a-z-word-list-term-collections/s/social-chatbot.md)
### [soft copy](a-z-word-list-term-collections/s/soft-copy.md)
From 3deda07fbe525f4968e3651d35afbd6a319189b3 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 17:13:34 +0200
Subject: [PATCH 101/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3a957778..1b89dba0 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,9 +14,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| April 30, 2021 | [invite](~/a-z-word-list-term-collections/term-collections/i/invite.md) | New topic.
-| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/term-collections/d/dark-mode.md) | New topic.
-| April 30, 2021 | [smb](~/a-z-word-list-term-collections/term-collections/s/smb.md) | New topic.
+| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
+| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/d/dark-mode.md) | New topic.
+| April 30, 2021 | [smb](~/a-z-word-list-term-collections/s/smb.md) | New topic.
| March 31, 2021 | [bits and bytes](~/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md) | Updated guidance on when to abbreviate certain terms.
| March 31, 2021 | [dialog box, dialog, dialogue](~/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md) | Updated guidance on use.
| March 29, 2021 | [check, checkbox, check mark](~/a-z-word-list-term-collections/c/check-checkbox-check-mark.md) | Updated guidance on use.
From 954b901c5714ab6453184edbac0f10cc04abea0b Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 17:14:50 +0200
Subject: [PATCH 102/486] Rename dark mode.md to dark-mode.md
---
.../d/{dark mode.md => dark-mode.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/d/{dark mode.md => dark-mode.md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/d/dark mode.md b/styleguide/a-z-word-list-term-collections/d/dark-mode.md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/d/dark mode.md
rename to styleguide/a-z-word-list-term-collections/d/dark-mode.md
From d1033a00af623b17b2570de4a81944d325d22950 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 30 Apr 2021 17:23:14 +0200
Subject: [PATCH 103/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 1b89dba0..dd4d4c83 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,7 +16,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/d/dark-mode.md) | New topic.
-| April 30, 2021 | [smb](~/a-z-word-list-term-collections/s/smb.md) | New topic.
+| April 30, 2021 | [SMB](~/a-z-word-list-term-collections/s/smb.md) | New topic.
| March 31, 2021 | [bits and bytes](~/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md) | Updated guidance on when to abbreviate certain terms.
| March 31, 2021 | [dialog box, dialog, dialogue](~/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md) | Updated guidance on use.
| March 29, 2021 | [check, checkbox, check mark](~/a-z-word-list-term-collections/c/check-checkbox-check-mark.md) | Updated guidance on use.
From 51eca5a827806424360e6f9b26c529fa2033180d Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Thu, 20 May 2021 10:29:16 +0200
Subject: [PATCH 104/486] Update hyphens.md
---
styleguide/punctuation/dashes-hyphens/hyphens.md | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md
index a51abc4a..eeefbfc8 100644
--- a/styleguide/punctuation/dashes-hyphens/hyphens.md
+++ b/styleguide/punctuation/dashes-hyphens/hyphens.md
@@ -2,7 +2,7 @@
title: Hyphens - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 09/6/2019
+ms.date: 05/20/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -137,11 +137,12 @@ For more information about using prefixes, see [*The Chicago Manual of Style*](h
Capitalize any part of a hyphenated compound word that would be capitalized if there were no hyphen.
**Examples**
-| Compound word | Example sentence |
-| ------------- |-------------|
-| Customer-friendly | Customer-friendly content is brief, accurate, and to the point.|
-|E-Book| Bisson, Guillermo. *The App E-Book*. Redmond, WA: Lucerne Publishing, 2015.|
-| Add-ins | Bisson, Guillermo. *Programming Office 365 Applications, SharePoint Add-ins, and More*. Redmond, WA: Lucerne Publishing, 2015. |
+
+| Compound word | Example sentence |
+| -------------------------- |-------------------------------------------------------------------------------------------------------------------------------|
+| Customer-friendly | Customer-friendly content is brief, accurate, and to the point. |
+| E-Book | Bisson, Guillermo. *The App E-Book*. Redmond, WA: Lucerne Publishing, 2015. |
+| Add-ins | Bisson, Guillermo. *Programming Office 365 Applications, SharePoint Add-ins, and More*. Redmond, WA: Lucerne Publishing, 2015.|
**See also** [Capitalization](/styleguide/capitalization.md).
From 7cf84e11b90496a94fca5130bf1a5ef17b92425f Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Thu, 20 May 2021 10:46:45 +0200
Subject: [PATCH 105/486] Update nouns-pronouns.md
---
styleguide/grammar/nouns-pronouns.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index 9f2c4793..2f420eae 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -70,7 +70,7 @@ Greek that retain their Latin or Greek endings (typically *-a, -us, -um, -on, -i
Don't use gendered pronouns in generic references. Instead, rewrite—for example, use the second person (*you*).
-Or refer to a person's role (*customer, employee,* or *client*). It's OK to use *he*,*she*, or *they* when
+Or refer to a person's role (*customer, employee,* or *client*). It's OK to use *he*, *she*, or *they* when
you're writing about real people who use those pronouns themselves.
*They* can be used as a non-binary pronoun for a singular person instead of a binary pronoun (*she* or *he*).
From 4a390f4f79017a00ba1fe3d335f8129ab0835711 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 31 May 2021 16:08:31 +0200
Subject: [PATCH 106/486] Create wellbeing.md
---
.../a-z-word-list-term-collections/w/wellbeing.md | 15 +++++++++++++++
1 file changed, 15 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/w/wellbeing.md
diff --git a/styleguide/a-z-word-list-term-collections/w/wellbeing.md b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
new file mode 100644
index 00000000..cbf73089
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
@@ -0,0 +1,15 @@
+---
+title: where - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 05/31/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# wellbeing
+
+Do not use *well-being*, but *wellbeing*. Do not hyphenate.
+
+**Example**
+MyAnalytics gives you insights into your work patterns around focus, network, *wellbeing*, and collaboration over the past four weeks.
From b2926c443a7baea80238f3b1e39f515ac4ad0b96 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 31 May 2021 16:10:06 +0200
Subject: [PATCH 107/486] Update TOC.md
---
styleguide/TOC.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 350224db..5376ad37 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -859,6 +859,7 @@
### [wearable, wearable device](a-z-word-list-term-collections/w/wearable-wearable-device.md)
### [web, World Wide Web, WWW](a-z-word-list-term-collections/w/web-world-wide-web-www.md)
### [web services](a-z-word-list-term-collections/w/web-services.md)
+### [wellbeing](a-z-word-list-term-collections/w/wellbeing.md)
### [where](a-z-word-list-term-collections/w/where.md)
### [while](a-z-word-list-term-collections/w/while.md)
### [white hat hacker](a-z-word-list-term-collections/w/white-hat-hacker.md)
From befed6e59bf696eae2baf6a95505161453cd169d Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 31 May 2021 16:11:32 +0200
Subject: [PATCH 108/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index dd4d4c83..f7952483 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -2,7 +2,7 @@
title: What's new? - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 04/30/2021
+ms.date: 05/31/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -14,6 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New topic.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/d/dark-mode.md) | New topic.
| April 30, 2021 | [SMB](~/a-z-word-list-term-collections/s/smb.md) | New topic.
From 52ba4376dbc01847982b75a5465683d746527aca Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Tue, 1 Jun 2021 15:54:02 +0200
Subject: [PATCH 109/486] Create workstream.md
---
.../w/workstream.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/w/workstream.md
diff --git a/styleguide/a-z-word-list-term-collections/w/workstream.md b/styleguide/a-z-word-list-term-collections/w/workstream.md
new file mode 100644
index 00000000..4ec3e3e8
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/w/workstream.md
@@ -0,0 +1,19 @@
+---
+title: workstream - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 05/31/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# workstream
+
+Use as one word without a hyphen.
+
+**Examples**
+*Workstreams* are channels within a team that aid the team in organizing their work.
+
+Each channel represents a different topic or *workstream* within the overall team.
+
+Creating channels is a great way to organize conversations and files by *workstream* or subject.
From 41b9fa0842fa12539ecd4e1b8789d672011f612c Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Tue, 1 Jun 2021 15:54:34 +0200
Subject: [PATCH 110/486] Update wellbeing.md
---
styleguide/a-z-word-list-term-collections/w/wellbeing.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/w/wellbeing.md b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
index cbf73089..4516e887 100644
--- a/styleguide/a-z-word-list-term-collections/w/wellbeing.md
+++ b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
@@ -1,5 +1,5 @@
---
-title: where - Microsoft Style Guide
+title: wellbeing - Microsoft Style Guide
author: pallep
ms.author: pallep
ms.date: 05/31/2021
From 437ab2a27d7be97714037f9554ea293b2bc56eee Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Tue, 1 Jun 2021 15:55:54 +0200
Subject: [PATCH 111/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index f7952483..c8e6ba12 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,7 +14,8 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New topic.
+| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
+| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/d/dark-mode.md) | New topic.
| April 30, 2021 | [SMB](~/a-z-word-list-term-collections/s/smb.md) | New topic.
From 53cdf3a1a9edf3ca862f1a3de3f9e3919ac94d2e Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Tue, 1 Jun 2021 15:57:22 +0200
Subject: [PATCH 112/486] Update TOC.md
---
styleguide/TOC.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 5376ad37..5a73bb89 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -883,6 +883,7 @@
### [workgroup](a-z-word-list-term-collections/w/workgroup.md)
### [working memory](a-z-word-list-term-collections/w/working-memory.md)
### [workstation](a-z-word-list-term-collections/w/workstation.md)
+### [workstream](a-z-word-list-term-collections/w/workstream.md)
### [worldwide vs. international](a-z-word-list-term-collections/w/worldwide-vs-international.md)
### [write-only](a-z-word-list-term-collections/w/write-only.md)
### [write-protect, write-protected](a-z-word-list-term-collections/w/write-protect-write-protected.md)
From d356633128082a08eba597e6f20e0951bdcd8517 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Tue, 6 Jul 2021 17:42:43 +0200
Subject: [PATCH 113/486] Corrected typo in Writing-tips.md
---
styleguide/global-communications/writing-tips.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/global-communications/writing-tips.md b/styleguide/global-communications/writing-tips.md
index ee89b55e..699db070 100644
--- a/styleguide/global-communications/writing-tips.md
+++ b/styleguide/global-communications/writing-tips.md
@@ -2,7 +2,7 @@
title: Writing tips - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 07/06/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -95,4 +95,4 @@ Configure limits for the backup. These limits should be based on the amount of s
**Example**
Configure limits for the backup. **Base the limits** on the amount of storage space available.
-**Use only common abbreviations,** such as *USB*, and abbreviations that are defined in glossaries. Check with a localization expert to find our if an acronym is defined.
+**Use only common abbreviations,** such as *USB*, and abbreviations that are defined in glossaries. Check with a localization expert to find out if an acronym is defined.
From 9a9ea5497bf0c4881d376c9b04d4642a0df02834 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 14:55:41 +0200
Subject: [PATCH 114/486] Link for Capitalization corrected
---
styleguide/punctuation/dashes-hyphens/hyphens.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md
index eeefbfc8..a6b9f9b2 100644
--- a/styleguide/punctuation/dashes-hyphens/hyphens.md
+++ b/styleguide/punctuation/dashes-hyphens/hyphens.md
@@ -144,5 +144,5 @@ Capitalize any part of a hyphenated compound word that would be capitalized if
| E-Book | Bisson, Guillermo. *The App E-Book*. Redmond, WA: Lucerne Publishing, 2015. |
| Add-ins | Bisson, Guillermo. *Programming Office 365 Applications, SharePoint Add-ins, and More*. Redmond, WA: Lucerne Publishing, 2015.|
-**See also** [Capitalization](/styleguide/capitalization.md).
+**See also** [Capitalization](~/styleguide/capitalization.md).
From 324c5bfb39b17823ac85b28f9862552fb16336d6 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 15:06:19 +0200
Subject: [PATCH 115/486] Correction of link for Capitalization
---
styleguide/punctuation/dashes-hyphens/hyphens.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md
index a6b9f9b2..99595524 100644
--- a/styleguide/punctuation/dashes-hyphens/hyphens.md
+++ b/styleguide/punctuation/dashes-hyphens/hyphens.md
@@ -144,5 +144,5 @@ Capitalize any part of a hyphenated compound word that would be capitalized if
| E-Book | Bisson, Guillermo. *The App E-Book*. Redmond, WA: Lucerne Publishing, 2015. |
| Add-ins | Bisson, Guillermo. *Programming Office 365 Applications, SharePoint Add-ins, and More*. Redmond, WA: Lucerne Publishing, 2015.|
-**See also** [Capitalization](~/styleguide/capitalization.md).
+**See also** [Capitalization](/capitalization.md).
From cc0f5b51c886552fa871755085411f395e2e7ba5 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 15:16:04 +0200
Subject: [PATCH 116/486] Update hyphens.md
---
styleguide/punctuation/dashes-hyphens/hyphens.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md
index 99595524..34a51d7c 100644
--- a/styleguide/punctuation/dashes-hyphens/hyphens.md
+++ b/styleguide/punctuation/dashes-hyphens/hyphens.md
@@ -144,5 +144,5 @@ Capitalize any part of a hyphenated compound word that would be capitalized if
| E-Book | Bisson, Guillermo. *The App E-Book*. Redmond, WA: Lucerne Publishing, 2015. |
| Add-ins | Bisson, Guillermo. *Programming Office 365 Applications, SharePoint Add-ins, and More*. Redmond, WA: Lucerne Publishing, 2015.|
-**See also** [Capitalization](/capitalization.md).
+**See also** [Capitalization](~/capitalization.md)
From e5397726137a8f57f6d08ca8cb841583200bd7d2 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 17:34:49 +0200
Subject: [PATCH 117/486] Create backlog grooming topic
---
.../b/backlog-grooming.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
diff --git a/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md b/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
new file mode 100644
index 00000000..e6ecd91b
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
@@ -0,0 +1,12 @@
+---
+title: backlog grooming - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 08/06/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# backlog grooming
+
+Don’t use. Replace with *backlog refinement* instead.
From 9d88eae06d4ca2c22b57d6fcb9f2d1699642bae7 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 17:45:01 +0200
Subject: [PATCH 118/486] Update TOC.md
---
styleguide/TOC.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 5a73bb89..c3320198 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -80,6 +80,7 @@
### [back up, backup](a-z-word-list-term-collections/b/back-up-backup.md)
### [backbone](a-z-word-list-term-collections/b/backbone.md)
### [backlight](a-z-word-list-term-collections/b/backlight.md)
+### [backlog grooming](a-z-word-list-term-collections/b/backlog-grooming.md)
### [backspace](a-z-word-list-term-collections/b/backspace.md)
### [backtab](a-z-word-list-term-collections/b/backtab.md)
### [badge](a-z-word-list-term-collections/b/badge.md)
From 4fc90eed0494a0d69df139530f62bf49c0b3daca Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Fri, 6 Aug 2021 17:53:27 +0200
Subject: [PATCH 119/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index c8e6ba12..8b436f6b 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -2,7 +2,7 @@
title: What's new? - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 05/31/2021
+ms.date: 08/06/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -14,6 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 6, 2021 | [backlog grooming](~/a-z-word-list-term-collections/b/backlog-grooming.md) | New topic.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
From a2a4e73956f6916ab0bd881196dfb1bce8cd90bb Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 9 Aug 2021 13:08:45 +0200
Subject: [PATCH 120/486] Update colons.md
---
styleguide/punctuation/colons.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index c16a53c1..a3c01454 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -46,3 +46,7 @@ When you use a colon in a title or heading, capitalize the word that follows it.
Block party: Communities use Minecraft to create public spaces
Why girls lose interest in STEM: New research has some answers
Get started with Azure IoT: An interactive developer guide
+
+## In UI
+
+Don’t use colon when introducing lists of radio buttons or checkboxes.
From 75304672111e134b4188b9f5b79ea9a209089529 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 9 Aug 2021 13:18:42 +0200
Subject: [PATCH 121/486] Update lists.md
---
styleguide/scannable-content/lists.md | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/styleguide/scannable-content/lists.md b/styleguide/scannable-content/lists.md
index fe47fe14..3d2afb4e 100644
--- a/styleguide/scannable-content/lists.md
+++ b/styleguide/scannable-content/lists.md
@@ -2,7 +2,7 @@
title: Lists - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/09/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -69,3 +69,7 @@ In bulleted and numbered lists, end each list item with a period if:
- Any item *by itself* is a complete sentence.
Don’t use semicolons, commas, or conjunctions (like *and* or *or*) at the end of list items.
+
+## In UI
+
+Often lists are a series of radio buttons or checkboxes inside dialog boxes or settings pages. Unless they’re complete sentences, don’t use punctuation for each item in a list. If punctuation is necessary for clarity, make sure punctuation is used consistently in the list and in other lists within the same section or screen.
From bb9b25410f2caf5191ad68ba2a3af03d637a8ef2 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 9 Aug 2021 13:19:16 +0200
Subject: [PATCH 122/486] Update colons.md
---
styleguide/punctuation/colons.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index a3c01454..cf76f53c 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -2,7 +2,7 @@
title: Colons - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 07/24/2018
+ms.date: 08/09/2021
ms.topic: article
ms.prod: non-product-specific
---
From ba9ef798685761fbac4f8e1a284f9dc0e7c7a09c Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Mon, 9 Aug 2021 13:57:52 +0200
Subject: [PATCH 123/486] Update units-of-measure-terms.md
---
.../term-collections/units-of-measure-terms.md | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
index 93e40e6b..e4791faf 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
@@ -2,7 +2,7 @@
title: Units of measure terms - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 03/12/2018
+ms.date: 08/09/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -76,6 +76,10 @@ to measurement. For other units of measure not covered here, see [*The Chicago M
||kilograms|kg|
||ounces|oz|
||pounds|lb|
+|**Area**|square foot|sq ft|
+||square meter|m2|
+|**Volume**|cubic foot|cu ft|
+||cubic meter|m3|
|**Type and fonts**|points|pt|
|**UI, display resolution, and digital imaging**|pixels|Don’t use the abbreviation *px* in the context of screen or camera resolution.
It’s OK to abbreviate as *px* in content about online design when space is limited.
**Examples** 48 × 48 px The application icon should be 62 × 62 pixels and PNG format.|
||pixels per inch|It’s OK to use the acronym *PPI* in content about creating digital applications, when space is limited, and when you’re certain that readers will understand it.
**Examples** 72 pixels per inch At 72 PPI, ….|
From f051fd5b1980710966a58d94200e727325317e9e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 10 Aug 2021 10:17:17 -0500
Subject: [PATCH 124/486] Update-date-time-terms.md
---
.../term-collections/date-time-terms.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 96464101..c303062d 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -2,7 +2,7 @@
title: Date and time terms - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 04/4/2019
+ms.date: 08/10/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -16,6 +16,7 @@ This section covers usage for terms related to time and date.
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10:45 AM 6:30 PM |
+| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
From a8db9bda87a05c907e8804751c318dbb4c308379 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 10 Aug 2021 11:15:23 -0500
Subject: [PATCH 125/486] Update-colons-in-time-terms.md
---
...s.md => term-collections-update-colons-in-time-terms.md} | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
rename styleguide/a-z-word-list-term-collections/term-collections/{date-time-terms.md => term-collections-update-colons-in-time-terms.md} (93%)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
similarity index 93%
rename from styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
rename to styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
index c303062d..0be623b5 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
@@ -15,14 +15,14 @@ This section covers usage for terms related to time and date.
| **Term** | **Usage** |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10:45 AM 6:30 PM |
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |╝╝╝Θ╝
| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
-| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
+| **midnight, noon** | Use *noon* and *midnight*. Don't use *12∶00 noon* and *12∶00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
| **Months: January–December** | Capitalize the names of months and their abbreviations.
Don't use abbreviations unless space is extremely limited. Use three-letter abbreviations when necessary: *Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* Don't include a period with the abbreviations. |
| **Seasons: Fall, autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
-| **Time, ranges of time** | Use numerals for times of day: 2:00, 4:15, 7:30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10:00 AM to 2:00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10:00 AM–2:00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2:15 AM–4:45 PM 4/1/16 (time range on a single day) 12/1/17 2:15 PM – 4/1/18 4:45 PM (time plus date range) |
+| **Time, ranges of time** | Use numerals for times of day: 2∶00, 4∶15, 7∶30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10∶00 AM to 2∶00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10∶00 AM–2∶00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2∶15 AM–4∶45 PM 4/1/16 (time range on a single day) 12/1/17 2∶15 PM – 4/1/18 4∶45 PM (time plus date range) |
| **Time zones: Eastern Time, Central Time, Mountain Time, Pacific Time, Coordinated Universal Time (UTC), Greenwich Mean Time (GMT)** | Capitalize time zones. Don't abbreviate unless space is severely limited. If you must abbreviate, use *ET, CT, MT,* and *PT*.
Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.
If you're referring to a time zone as a geographical area, call it a zone. **Example** in the Pacific Time zone
Not all time zones have names, and some time-zone names are used in more than one geographical area. If you're talking about a particular place, clarify the country or reference Coordinated Universal Time (UTC). Don't include spaces around the plus sign (+) or hyphen (-). **Examples** Eastern Time (UTC-5) Eastern Time (UTC+10) Eastern Time (Australia)
For time zones without names, refer to the offset from Coordinated Universal Time. **Example** UTC+7
Don't abbreviate *Coordinated Universal Time* in text unless space is severely limited. Use *UTC,* never *CUT*. (It's OK to use UTC in references to a specific time zone, such as *UTC+7*.) Don't use *Universal Time Coordinate or Universal Time Coordinated*.
Don't use *Greenwich Mean Time* or *GMT* by itself unless you have no other choice. Use *Coordinated Universal Time* instead. On the first mention, it's OK to refer to *Coordinated Universal Time (Greenwich Mean Time)*. |
## Abbreviating units of time
From 3551ab35284878dbb7ece40d7ce23a3d0543196f Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 10 Aug 2021 11:33:55 -0500
Subject: [PATCH 126/486] Revert "Update-colons-in-time-terms.md"
---
...ns-update-colons-in-time-terms.md => date-time-terms.md} | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
rename styleguide/a-z-word-list-term-collections/term-collections/{term-collections-update-colons-in-time-terms.md => date-time-terms.md} (93%)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
similarity index 93%
rename from styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
rename to styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 0be623b5..c303062d 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -15,14 +15,14 @@ This section covers usage for terms related to time and date.
| **Term** | **Usage** |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |╝╝╝Θ╝
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10:45 AM 6:30 PM |
| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
-| **midnight, noon** | Use *noon* and *midnight*. Don't use *12∶00 noon* and *12∶00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
+| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
| **Months: January–December** | Capitalize the names of months and their abbreviations.
Don't use abbreviations unless space is extremely limited. Use three-letter abbreviations when necessary: *Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* Don't include a period with the abbreviations. |
| **Seasons: Fall, autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
-| **Time, ranges of time** | Use numerals for times of day: 2∶00, 4∶15, 7∶30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10∶00 AM to 2∶00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10∶00 AM–2∶00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2∶15 AM–4∶45 PM 4/1/16 (time range on a single day) 12/1/17 2∶15 PM – 4/1/18 4∶45 PM (time plus date range) |
+| **Time, ranges of time** | Use numerals for times of day: 2:00, 4:15, 7:30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10:00 AM to 2:00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10:00 AM–2:00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2:15 AM–4:45 PM 4/1/16 (time range on a single day) 12/1/17 2:15 PM – 4/1/18 4:45 PM (time plus date range) |
| **Time zones: Eastern Time, Central Time, Mountain Time, Pacific Time, Coordinated Universal Time (UTC), Greenwich Mean Time (GMT)** | Capitalize time zones. Don't abbreviate unless space is severely limited. If you must abbreviate, use *ET, CT, MT,* and *PT*.
Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.
If you're referring to a time zone as a geographical area, call it a zone. **Example** in the Pacific Time zone
Not all time zones have names, and some time-zone names are used in more than one geographical area. If you're talking about a particular place, clarify the country or reference Coordinated Universal Time (UTC). Don't include spaces around the plus sign (+) or hyphen (-). **Examples** Eastern Time (UTC-5) Eastern Time (UTC+10) Eastern Time (Australia)
For time zones without names, refer to the offset from Coordinated Universal Time. **Example** UTC+7
Don't abbreviate *Coordinated Universal Time* in text unless space is severely limited. Use *UTC,* never *CUT*. (It's OK to use UTC in references to a specific time zone, such as *UTC+7*.) Don't use *Universal Time Coordinate or Universal Time Coordinated*.
Don't use *Greenwich Mean Time* or *GMT* by itself unless you have no other choice. Use *Coordinated Universal Time* instead. On the first mention, it's OK to refer to *Coordinated Universal Time (Greenwich Mean Time)*. |
## Abbreviating units of time
From a976ac2dc7ce3f9a4302c8445f716d45dad7a3b6 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 10 Aug 2021 11:44:01 -0500
Subject: [PATCH 127/486] Fixing-colons.md
---
...in-time-terms.md => term-collections-date-and-time-terms.md} | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
rename styleguide/a-z-word-list-term-collections/term-collections/{term-collections-update-colons-in-time-terms.md => term-collections-date-and-time-terms.md} (99%)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/term-collections-date-and-time-terms.md
similarity index 99%
rename from styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
rename to styleguide/a-z-word-list-term-collections/term-collections/term-collections-date-and-time-terms.md
index 0be623b5..844bc3bf 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/term-collections-update-colons-in-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/term-collections-date-and-time-terms.md
@@ -15,7 +15,7 @@ This section covers usage for terms related to time and date.
| **Term** | **Usage** |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |╝╝╝Θ╝
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
From 5753c6f0f7e4107d159a007ec4c962ebe5138408 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 10 Aug 2021 11:47:06 -0500
Subject: [PATCH 128/486] fixing-mistakes
---
...term-collections-date-and-time-terms.md => date-time-terms.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/term-collections/{term-collections-date-and-time-terms.md => date-time-terms.md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/term-collections-date-and-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/term-collections/term-collections-date-and-time-terms.md
rename to styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
From c5ef4d3699345696b6f8f48715ef131963c64932 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Wed, 11 Aug 2021 15:21:39 +0200
Subject: [PATCH 129/486] Fixing colons_maite
---
.../term-collections/date-time-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 844bc3bf..2e961058 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -15,7 +15,7 @@ This section covers usage for terms related to time and date.
| **Term** | **Usage** |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
From 9025e2b36d1002b2d9b062a33d4904eb74020ddf Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Wed, 11 Aug 2021 17:11:56 +0200
Subject: [PATCH 130/486] Update date-time-terms.md
---
.../term-collections/date-time-terms.md | 13 +++++--------
1 file changed, 5 insertions(+), 8 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index b45d432b..027bb0bf 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -2,7 +2,7 @@
title: Date and time terms - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 08/10/2021
+ms.date: 08/11/2019
ms.topic: article
ms.prod: non-product-specific
---
@@ -15,17 +15,14 @@ This section covers usage for terms related to time and date.
| **Term** | **Usage** |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
- | Use numerals for times of day: 2∶00, 4∶15, 7∶30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10∶00 AM to 2∶00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10∶00 AM–2∶00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2∶15 AM–4∶45 PM 4/1/16 (time range on a single day) 12/1/17 2∶15 PM – 4/1/18 4∶45 PM (time plus date range) |
-
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10:45 AM 6:30 PM |
-| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
+| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
-| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
+| **midnight, noon** | Use *noon* and *midnight*. Don't use *12∶00 noon* and *12∶00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
| **Months: January–December** | Capitalize the names of months and their abbreviations.
Don't use abbreviations unless space is extremely limited. Use three-letter abbreviations when necessary: *Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* Don't include a period with the abbreviations. |
| **Seasons: Fall, autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
-| **Time, ranges of time** | Use numerals for times of day: 2:00, 4:15, 7:30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10:00 AM to 2:00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10:00 AM–2:00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2:15 AM–4:45 PM 4/1/16 (time range on a single day) 12/1/17 2:15 PM – 4/1/18 4:45 PM (time plus date range) |
-
+| **Time, ranges of time** | Use numerals for times of day: 2∶00, 4∶15, 7∶30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10∶00 AM to 2∶00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10∶00 AM–2∶00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2∶15 AM–4∶45 PM 4/1/16 (time range on a single day) 12/1/17 2∶15 PM – 4/1/18 4∶45 PM (time plus date range) |
| **Time zones: Eastern Time, Central Time, Mountain Time, Pacific Time, Coordinated Universal Time (UTC), Greenwich Mean Time (GMT)** | Capitalize time zones. Don't abbreviate unless space is severely limited. If you must abbreviate, use *ET, CT, MT,* and *PT*.
Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.
If you're referring to a time zone as a geographical area, call it a zone. **Example** in the Pacific Time zone
Not all time zones have names, and some time-zone names are used in more than one geographical area. If you're talking about a particular place, clarify the country or reference Coordinated Universal Time (UTC). Don't include spaces around the plus sign (+) or hyphen (-). **Examples** Eastern Time (UTC-5) Eastern Time (UTC+10) Eastern Time (Australia)
For time zones without names, refer to the offset from Coordinated Universal Time. **Example** UTC+7
Don't abbreviate *Coordinated Universal Time* in text unless space is severely limited. Use *UTC,* never *CUT*. (It's OK to use UTC in references to a specific time zone, such as *UTC+7*.) Don't use *Universal Time Coordinate or Universal Time Coordinated*.
Don't use *Greenwich Mean Time* or *GMT* by itself unless you have no other choice. Use *Coordinated Universal Time* instead. On the first mention, it's OK to refer to *Coordinated Universal Time (Greenwich Mean Time)*. |
## Abbreviating units of time
From a2d45db3ab301e98142f97a7251ec00bdb68a9c8 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 11 Aug 2021 10:27:54 -0500
Subject: [PATCH 131/486] Update numbers.md
colons/ratios
---
styleguide/numbers.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/numbers.md b/styleguide/numbers.md
index 1186f142..8f71daa5 100644
--- a/styleguide/numbers.md
+++ b/styleguide/numbers.md
@@ -2,7 +2,7 @@
title: Numbers - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 09/18/2019
+ms.date: 08/11/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -53,7 +53,7 @@ all other content, follow the guidelines below.
| A number the customer is directed to enter. | Enter **5**. |
| A round number of 1 million or more. | 7 million |
| Dimensions. Spell out _by,_ except for tile sizes, screen resolutions, and paper sizes. For those, use the multiplication sign (×). Use a space before and after the multiplication sign. | 10-foot cable 4 × 4 tile 8.5" × 11" paper 1280 × 1024 |
-| Time of day. Include _AM_ or _PM._ **Exception** Don't use numerals for _12:00_. Use _noon_ or _midnight_ instead. Include the time zone if you're discussing an event, and customers beyond the local time zone may see it. Time stamps in UI and websites usually display local time and date automatically. | 10:45 AM 6:30 PM The meeting is at noon. The event starts at 5:00 PM Pacific Time. The date changes at midnight. |
+| Time of day. Include _AM_ or _PM._ **Exception** Don't use numerals for _12∶00_. Use _noon_ or _midnight_ instead. Include the time zone if you're discussing an event, and customers beyond the local time zone may see it. Time stamps in UI and websites usually display local time and date automatically. | 10∶45 AM 6∶30 PM The meeting is at noon. The event starts at 5∶00 PM Pacific Time. The date changes at midnight. |
| Percentages, no matter how small. Use a numeral plus _percent_ to specify a percentage. Use _percentage_ when you don't specify a quantity. | At least 50 percent of your system resources should be available. Only 1 percent of the test group was unable to complete the task. A large percentage of system resources should be available. |
| Coordinates of tables or worksheets and numbered sections of documents. | row 3, column 4 Volume 2 Chapter 10 Part 5 step 1 |
@@ -151,7 +151,7 @@ all other content, follow the guidelines below.
**Exceptions**
Use an en dash in a range of pages or where space is an issue, such as in tables and UI. For example, *2016–2020* and *pages 112–120.*
- Use *to* in a range of times. For example, *10:00 AM to 2:00 PM.*
+ Use *to* in a range of times. For example, *10∶00 AM to 2∶00 PM.*
- Don't use *from* before a range indicated by an en dash, such as *10–15*.
From 15ad1e1941c4da6666c356bbb2fb5584f5fd4a2d Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 12 Aug 2021 13:02:02 -0500
Subject: [PATCH 132/486] Update colons.md
---
styleguide/punctuation/colons.md | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index cf76f53c..768de1d1 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -2,7 +2,7 @@
title: Colons - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 08/09/2021
+ms.date: 08/12/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -50,3 +50,9 @@ Get started with Azure IoT: An interactive developer guide
## In UI
Don’t use colon when introducing lists of radio buttons or checkboxes.
+
+## When displaying clock time
+
+Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](~/scannable-content/date-and-time-terms.md).
+**Example**
+The meeting is scheduled for 1∶00 PM.
From 853f9c0ffa0388598a14afa10386ad01056e9019 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 12 Aug 2021 13:03:03 -0500
Subject: [PATCH 133/486] Update colons.md
---
styleguide/punctuation/colons.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index 768de1d1..a38e6c0c 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -53,6 +53,6 @@ Don’t use colon when introducing lists of radio buttons or checkboxes.
## When displaying clock time
-Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](~/scannable-content/date-and-time-terms.md).
+Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md).
**Example**
The meeting is scheduled for 1∶00 PM.
From 115c29fd889ff428fe8dc7c07e04320836b97fb3 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 12 Aug 2021 13:08:14 -0500
Subject: [PATCH 134/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 +++
1 file changed, 3 insertions(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 8b436f6b..1f13cc1c 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,6 +14,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 12, 2021 | [colons](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/punctuation/colons.md) | Updated guidance on use of colons in clock time.
+| August 11, 2021 | [numbers](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/numbers.md) | Replaced colons with ratio symbols.
+| August 10, 2021 | [date and time terms](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md) | New section on clock time.
| August 6, 2021 | [backlog grooming](~/a-z-word-list-term-collections/b/backlog-grooming.md) | New topic.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
From 9131846fad3f76b1152fb07b266b4269d4345e28 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 17 Aug 2021 10:22:24 -0500
Subject: [PATCH 135/486] Update dont-use-common-words-in-new-ways.md
period outside parentheses
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index 67ff9fd8..cfa8bee8 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -9,7 +9,7 @@ ms.prod: non-product-specific
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary ([*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact.) Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary ([*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact). Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
**Example**
From 2829061f1ddb07ef4359b1b2b464cf589740a0e0 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 17 Aug 2021 10:27:12 -0500
Subject: [PATCH 136/486] Revert "Update dont-use-common-words-in-new-ways.md"
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index cfa8bee8..67ff9fd8 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -9,7 +9,7 @@ ms.prod: non-product-specific
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary ([*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact). Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary ([*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact.) Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
**Example**
From 920cacbef10244be24af2b5878a5c4106728809b Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 17 Aug 2021 10:28:33 -0500
Subject: [PATCH 137/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index cfa8bee8..08524065 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -13,11 +13,11 @@ Most people know the common definition of words—usually the one that appears f
- Don’t create a new word from an existing word.
**Example**
- Don’t use *bucketize* to mean *group.*
+ Don’t use *bucketize* to mean *group*.
- Don't apply a new meaning to an ordinary word.
**Example**
- Don’t use *graveyard* to mean *archive.*
+ Don’t use *graveyard* to mean *archive*.
- Be
careful with common words that have industry-specific uses.
@@ -25,7 +25,7 @@ Most people know the common definition of words—usually the one that appears f
the industry-specific definition. If you must
use the industry-specific definition, define the word in
context.
- **Writing tip** Sometimes industry-specific usage, such as *hacker,*
+ **Writing tip** Sometimes industry-specific usage, such as *hacker*,
becomes part of everyday speech. Know your customer and the
language they use. When in doubt, use a simple word with a
well-understood meaning.
From 8a3ad8e9e9c9669dc733c53e350c3841543913fc Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 11:01:59 -0500
Subject: [PATCH 138/486] Create touch-sensitive.md
---
.../t/touch-sensitive.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
diff --git a/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md b/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
new file mode 100644
index 00000000..e269cca8
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
@@ -0,0 +1,12 @@
+---
+title: touch-sensitive - Microsoft Style Guide
+author: pallep
+ms.author: pallep
+ms.date: 08/25/2021
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# touch-sensitive
+
+Always hyphenate.
From 7658e24b09d0d5f2b54cb87097699a1e4a80540f Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 11:30:42 -0500
Subject: [PATCH 139/486] Update bias-free-communication.md
---
styleguide/bias-free-communication.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md
index 25bdb4cd..62883bc5 100644
--- a/styleguide/bias-free-communication.md
+++ b/styleguide/bias-free-communication.md
@@ -90,6 +90,8 @@ countries with states or continents.
**Focus on people, not disabilities.** For example, talk about readers who are blind or have low vision and customers with limited dexterity. Don't use words that imply pity, such as *stricken with* or *suffering from.* Don't mention a disability unless it's relevant. For more information, see the [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
+**Inclusive language** Capitalize Asian, Black and African American, Hispanic and Latinx, Native American, Alaska Native, Native Hawaiian, Pacific Islander, and Indigenous Peoples. Do not capitalize multiracial or white, per AP style. For additional and updated guidance on inclusive language, please refer to the [Communications and Creative Diversity & Inclusion Guide](https://aka.ms/DICommsCreativeGuide).
+
**Learn more** For more information about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
**See also** [Accessibility guidelines and requirements](~/accessibility/accessibility-guidelines-requirements.md), [Global communications](~/global-communications/index.md)
From 5547cb75257980b3a6e9cd096c492922c4dd3bc0 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 11:30:58 -0500
Subject: [PATCH 140/486] Update bias-free-communication.md
---
styleguide/bias-free-communication.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md
index 62883bc5..9ff69d9b 100644
--- a/styleguide/bias-free-communication.md
+++ b/styleguide/bias-free-communication.md
@@ -2,7 +2,7 @@
title: Bias-free communication - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 09/13/2019
+ms.date: 08/25/2021
ms.topic: article
ms.prod: non-product-specific
---
From 13eaae0ecdeb863271326b6f90433537581d1646 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 14:15:58 -0500
Subject: [PATCH 141/486] Update dont-use-common-words-in-new-ways.md
changing date
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index 08524065..683357aa 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -2,7 +2,7 @@
title: Don't use common words in new ways - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 04/30/2021
+ms.date: 08/25/2021
ms.topic: article
ms.prod: non-product-specific
---
From 973d6ddaa2afe789c3a10b3d2a467c9df021bd09 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 14:45:20 -0500
Subject: [PATCH 142/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index 683357aa..3b4eb70e 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -9,7 +9,7 @@ ms.prod: non-product-specific
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary ([*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact). Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary -[*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact. Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
**Example**
From 867fa7a5fad249cf211d62dadffc0e309c9fef9f Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 14:46:01 -0500
Subject: [PATCH 143/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index 3b4eb70e..c79fefa8 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -9,7 +9,7 @@ ms.prod: non-product-specific
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary -[*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact. Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary. Refer to [*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact. Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
**Example**
From f350d9f227e984b8fa45c340e68e127a25ef1098 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 25 Aug 2021 14:48:07 -0500
Subject: [PATCH 144/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index c79fefa8..c84329f4 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -9,7 +9,7 @@ ms.prod: non-product-specific
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary. Refer to [*The American Heritage Dictionary*](https://ahdictionary.com/), to be exact. Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary. Refer to [*The American Heritage Dictionary*](https://ahdictionary.com/) if you have any doubts. Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
**Example**
From 8b8a761b4837f1edcdc3606f4cd06d8040b9a9a4 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Thu, 26 Aug 2021 13:53:46 +0200
Subject: [PATCH 145/486] Update multi.md
---
styleguide/a-z-word-list-term-collections/m/multi.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/m/multi.md b/styleguide/a-z-word-list-term-collections/m/multi.md
index 981feae9..b24fb95a 100644
--- a/styleguide/a-z-word-list-term-collections/m/multi.md
+++ b/styleguide/a-z-word-list-term-collections/m/multi.md
@@ -2,7 +2,7 @@
title: multi- - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -11,6 +11,6 @@ ms.prod: non-product-specific
In general, don't hyphenate words beginning with *multi-* unless it's necessary to avoid confusion or *multi-* is followed by a proper noun. Check [*The American Heritage Dictionary*](https://ahdictionary.com/). If you don't find the word there or in the following list, use *multiple* before the word instead. Don't invent new words by combining words with *multi-.*
-**Examples** multicast multichannel multicolumn multilevel multiline multilingual multimedia multiprocessor multitasking multiuser
+**Examples** multicast multichannel multicloud multicolumn multilevel multiline multilingual multimedia multiprocessor multitasking multiuser
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From e786e675946d8036547bc11cda837ee056df34d6 Mon Sep 17 00:00:00 2001
From: Maite Sadaba Ch <78594119+maitesadaba@users.noreply.github.com>
Date: Thu, 26 Aug 2021 14:02:44 +0200
Subject: [PATCH 146/486] Updated whats new for multi
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 1f13cc1c..b03c1f0c 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -2,7 +2,7 @@
title: What's new? - Microsoft Style Guide
author: pallep
ms.author: pallep
-ms.date: 08/06/2021
+ms.date: 08/26/2021
ms.topic: article
ms.prod: non-product-specific
---
@@ -14,6 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 26, 2021 | [multi](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/m/multi.md) | Added exception to guideline.
| August 12, 2021 | [colons](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/punctuation/colons.md) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/numbers.md) | Replaced colons with ratio symbols.
| August 10, 2021 | [date and time terms](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md) | New section on clock time.
From 0327329056784c6ff2d9c2df6793c02cde65f3e8 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 26 Aug 2021 09:15:03 -0500
Subject: [PATCH 147/486] Update TOC.md
---
styleguide/TOC.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index c3320198..018c728c 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -802,6 +802,7 @@
### [top-level folder](a-z-word-list-term-collections/t/top-level-folder.md)
### [touchpad](a-z-word-list-term-collections/t/touchpad.md)
### [touchscreen](a-z-word-list-term-collections/t/touchscreen.md)
+### [touch-sensitive](a-z-word-list-term-collections/t/touch-sensitive.md)
### [toward](a-z-word-list-term-collections/t/toward.md)
### [trackball](a-z-word-list-term-collections/t/trackball.md)
### [trailing](a-z-word-list-term-collections/t/trailing.md)
From bc07f187c9a84fdb3f9632ea70888390cc2b91f4 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 26 Aug 2021 09:22:07 -0500
Subject: [PATCH 148/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index b03c1f0c..cd5b7d8e 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,6 +14,8 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 26, 2021 | [touch-sensitive](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md) | Added new topic.
+| August 25, 2021 | [Bias-free communication](~/bias-free-communication.md) | Added guidance about inclusive language.
| August 26, 2021 | [multi](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/m/multi.md) | Added exception to guideline.
| August 12, 2021 | [colons](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/punctuation/colons.md) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/numbers.md) | Replaced colons with ratio symbols.
From 14ac1d57571381648f38ddca0013d8ffbfed2fdb Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 26 Aug 2021 09:23:42 -0500
Subject: [PATCH 149/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index cd5b7d8e..2f866f54 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,9 +14,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 26, 2021 | [multi](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/m/multi.md) | Added exception to guideline.
| August 26, 2021 | [touch-sensitive](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md) | Added new topic.
| August 25, 2021 | [Bias-free communication](~/bias-free-communication.md) | Added guidance about inclusive language.
-| August 26, 2021 | [multi](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/m/multi.md) | Added exception to guideline.
| August 12, 2021 | [colons](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/punctuation/colons.md) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/numbers.md) | Replaced colons with ratio symbols.
| August 10, 2021 | [date and time terms](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md) | New section on clock time.
From a4b6cfa8b5a1c69c7eeb0f2b09f2c187d661bf48 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 26 Aug 2021 09:32:21 -0500
Subject: [PATCH 150/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 2f866f54..421670bc 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,13 +14,13 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| August 26, 2021 | [multi](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/m/multi.md) | Added exception to guideline.
-| August 26, 2021 | [touch-sensitive](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md) | Added new topic.
-| August 25, 2021 | [Bias-free communication](~/bias-free-communication.md) | Added guidance about inclusive language.
-| August 12, 2021 | [colons](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/punctuation/colons.md) | Updated guidance on use of colons in clock time.
-| August 11, 2021 | [numbers](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/numbers.md) | Replaced colons with ratio symbols.
-| August 10, 2021 | [date and time terms](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/master/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md) | New section on clock time.
-| August 6, 2021 | [backlog grooming](~/a-z-word-list-term-collections/b/backlog-grooming.md) | New topic.
+| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added exception to guideline.
+| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
+| August 25, 2021 | [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication) | Added guidance about inclusive language.
+| August 12, 2021 | [colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
+| August 11, 2021 | [numbers](https://docs.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
+| August 10, 2021 | [date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
+| August 6, 2021 | [backlog grooming](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/backlog-grooming) | New topic.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
From f71fd2842939fff9cfccbfb9093d95e4e4f3ea6b Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 21 Sep 2021 09:25:22 -0500
Subject: [PATCH 151/486] Update index.md
---
styleguide/welcome/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/index.md b/styleguide/welcome/index.md
index 77485b46..e97fbc56 100644
--- a/styleguide/welcome/index.md
+++ b/styleguide/welcome/index.md
@@ -3,7 +3,7 @@ title: Welcome - Microsoft Style Guide
description: The online Microsoft Writing Style Guide provides up-to-date style and terminology guidelines. It replaces the Microsoft Manual of Style.
author: pallep
ms.author: pallep
-ms.date: 03/16/2021
+ms.date: 08/26/2021
ms.topic: article
ms.prod: non-product-specific
---
From c5b85e588198c08f44654798b0f00203249fa66c Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Tue, 21 Sep 2021 13:00:31 -0500
Subject: [PATCH 152/486] updating inclusive language
---
styleguide/bias-free-communication.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md
index 9ff69d9b..7f5cfa23 100644
--- a/styleguide/bias-free-communication.md
+++ b/styleguide/bias-free-communication.md
@@ -90,7 +90,9 @@ countries with states or continents.
**Focus on people, not disabilities.** For example, talk about readers who are blind or have low vision and customers with limited dexterity. Don't use words that imply pity, such as *stricken with* or *suffering from.* Don't mention a disability unless it's relevant. For more information, see the [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
-**Inclusive language** Capitalize Asian, Black and African American, Hispanic and Latinx, Native American, Alaska Native, Native Hawaiian, Pacific Islander, and Indigenous Peoples. Do not capitalize multiracial or white, per AP style. For additional and updated guidance on inclusive language, please refer to the [Communications and Creative Diversity & Inclusion Guide](https://aka.ms/DICommsCreativeGuide).
+**Inclusive language** Use title-style capitalization for Asian, Black and African American, Hispanic and Latinx, Native American, Alaska Native, Native Hawaiian, Pacific Islander, and Indigenous Peoples. Microsoft style is to lowercase multiracial and white.
+
+For additional guidance on inclusive language in your content, refer to the Microsoft [Communications and Creative Diversity & Inclusion Guide](https://aka.ms/DICommsCreativeGuide). This guidance for is for external partners creating content for Global Diversity & Inclusion initiatives and is also a helpful resource for Microsoft employees seeking to be more inclusive in their business and interpersonal communications. (This site requires Microsoft network access.)
**Learn more** For more information about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
From ac7a2c40186369a41e659db65d1f7ac9054e09ba Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 29 Sep 2021 13:58:34 -0500
Subject: [PATCH 153/486] Delete backlog-grooming.md
---
.../b/backlog-grooming.md | 12 ------------
1 file changed, 12 deletions(-)
delete mode 100644 styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
diff --git a/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md b/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
deleted file mode 100644
index e6ecd91b..00000000
--- a/styleguide/a-z-word-list-term-collections/b/backlog-grooming.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: backlog grooming - Microsoft Style Guide
-author: pallep
-ms.author: pallep
-ms.date: 08/06/2021
-ms.topic: article
-ms.prod: non-product-specific
----
-
-# backlog grooming
-
-Don’t use. Replace with *backlog refinement* instead.
From 318d58ef8cef5fbd389485b041125c9fe837369e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 29 Sep 2021 14:01:03 -0500
Subject: [PATCH 154/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 421670bc..68b88821 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,13 +14,12 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added exception to guideline.
+| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
-| August 25, 2021 | [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication) | Added guidance about inclusive language.
+| August 25, 2021 | [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication) | Added inclusive language section.
| August 12, 2021 | [colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](https://docs.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
| August 10, 2021 | [date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
-| August 6, 2021 | [backlog grooming](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/backlog-grooming) | New topic.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
From a9dec8c62417b3105bdaed8537e831eae345d77e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 29 Sep 2021 14:10:24 -0500
Subject: [PATCH 155/486] Update TOC.md
---
styleguide/TOC.md | 2 --
1 file changed, 2 deletions(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 018c728c..ef8cb875 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -79,8 +79,6 @@
### [back end, back-end](a-z-word-list-term-collections/b/back-end.md)
### [back up, backup](a-z-word-list-term-collections/b/back-up-backup.md)
### [backbone](a-z-word-list-term-collections/b/backbone.md)
-### [backlight](a-z-word-list-term-collections/b/backlight.md)
-### [backlog grooming](a-z-word-list-term-collections/b/backlog-grooming.md)
### [backspace](a-z-word-list-term-collections/b/backspace.md)
### [backtab](a-z-word-list-term-collections/b/backtab.md)
### [badge](a-z-word-list-term-collections/b/badge.md)
From f6b4195bc2e9871d383ca3b27f97299513cc2758 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Mon, 18 Oct 2021 16:33:36 -0500
Subject: [PATCH 156/486] Update tables.md
---
styleguide/scannable-content/tables.md | 3 +++
1 file changed, 3 insertions(+)
diff --git a/styleguide/scannable-content/tables.md b/styleguide/scannable-content/tables.md
index 5516fe2b..69105fb2 100644
--- a/styleguide/scannable-content/tables.md
+++ b/styleguide/scannable-content/tables.md
@@ -57,6 +57,9 @@ the first row of your table contains column headings, you have a header
row. Distinguish the text in the header row from the rest of the text
in the table. For example, make it larger, bolder, or a different color.
+Column
+headers identify the data each column contains. Make headings precise for usability. For example, don't use "Name". Instead, make column headers specific as in "Group" or "Employee". (While screen readers use header information to identify rows and columns, specificity helps all users find the information they're looking for.)
+
Don’t
organize a table so that the column heading forms a complete sentence
when combined with the cell contents. This can make the table difficult
From 9fa84b7ad38969eedbdaebc704c31c18c407500f Mon Sep 17 00:00:00 2001
From: Khairunj
Date: Tue, 9 Nov 2021 23:11:04 -0800
Subject: [PATCH 157/486] Config changes to reflect the default branch from
master to main.
---
.openpublishing.publish.config.json | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
index 68517d56..acc9d1c5 100644
--- a/.openpublishing.publish.config.json
+++ b/.openpublishing.publish.config.json
@@ -24,7 +24,7 @@
],
"branches_to_filter": [],
"git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/microsoft-style-guide",
- "git_repository_branch_open_to_public_contributors": "master",
+ "git_repository_branch_open_to_public_contributors": "main",
"skip_source_output_uploading": false,
"need_preview_pull_request": true,
"contribution_branch_mappings": {},
@@ -32,13 +32,13 @@
{
"path_to_root": "_themes",
"url": "https://github.com/Microsoft/templates.docs.msft",
- "branch": "master",
+ "branch": "main",
"branch_mapping": {}
},
{
"path_to_root": "_themes.pdf",
"url": "https://github.com/Microsoft/templates.docs.msft.pdf",
- "branch": "master",
+ "branch": "main",
"branch_mapping": {}
}
],
@@ -57,4 +57,4 @@
"docs_build_engine": {
"name": "docfx_v3"
}
-}
+}
\ No newline at end of file
From 5ff11a43ff5f1f8e4b64ce8582a0e6b2bad6617c Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 9 Dec 2021 11:55:46 -0600
Subject: [PATCH 158/486] Update sql-sql-server.md
---
.../s/sql-sql-server.md | 11 +++++------
1 file changed, 5 insertions(+), 6 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md b/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
index fe4871bc..6ffae682 100644
--- a/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
+++ b/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
@@ -11,11 +11,10 @@ ms.prod: non-product-specific
When you're referring to a computer that's running Microsoft SQL Server, use *a computer running SQL Server* or *a computer that's running SQL Server*. (Note the capital *S* in *Server*.)
-Never refer to a computer that's running Microsoft SQL Server as any of the following:
+When you're referring to Structured Query Language as *SQL,* treat *SQL* as an acronym pronounced “sequel” and use the indefinite article *a:* *a* *SQL database.*
- - the SQL Server
- - a SQL Server
- - SQL Servers
- - SQL server
+**Examples**
-When you're referring to Structured Query Language as *SQL,* use the indefinite article *an:* *an* *SQL database.*
+Connect Power BI to an external data source, such as a SQL database.
+
+Review installation requirements, system configuration checks, and security considerations for a SQL Server installation.
From 0aefb9d72436503ed04b77ca45dd773416a322bf Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 9 Dec 2021 12:02:57 -0600
Subject: [PATCH 159/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 68b88821..2c3c52c1 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,6 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| December 9, 2021 | [SQL, SQL server](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
| August 25, 2021 | [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication) | Added inclusive language section.
From 6d1768dc5069a76a610955896c481383ab5a22eb Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 15 Dec 2021 14:47:17 -0600
Subject: [PATCH 160/486] Update cloud-computing-terms.md
---
.../term-collections/cloud-computing-terms.md | 38 +++++++++++--------
1 file changed, 22 insertions(+), 16 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
index 46333683..4b6b98e6 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
@@ -22,22 +22,28 @@ information about creating new terms or using emerging terminology, see [Use tec
| **Term** | **Usage** |
|-------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **cloud** | Don't capitalize. Don't use *Microsoft Cloud* or *the Cloud.*
Use *cloud* mostly as an adjective. Use sparingly as a noun *(the cloud).*
Don't use *cloud* interchangeably with *internet* or *web*. |
-| **cloud platform, cloud services** | Use *cloud platform* only in content for a technical audience, such as content about Azure. In content for a general audience, just refer to cloud services. |
-| **community cloud** | Never use. Use *hybrid cloud,* *private cloud,* or *hosted private cloud* instead. |
-| **dynamic service capacity** | Don't use. Use *elastic service capacity* instead. |
-| **elastic service capacity** | Use to describe the flexible allocation of computing resources over the internet as demand changes. Define on first mention for audiences that might not be familiar with the concept. |
-| **hosted service** | Use to describe a service, an IT solution, or an application that's hosted by a service provider and made available to customers over the internet. |
-| **hosting provider, hoster** | It's OK to use *cloud hosting provider* and *web hosting provider,* if necessary, to distinguish cloud service providers from web hosts. Don't use *hoster*. |
+| **as a service (-aaS)** | Use only *as a service (-aaS)* terms included in this term list.
Don’t create new *as a service* terms or *-aaS* acronyms. Instead, describe the service and what it provides the customer.
+| **cloud, the cloud** | Don't capitalize *cloud* except in references to the Microsoft Cloud or when it's part of a product name.
Use *cloud* mostly as an adjective. Use sparingly as a noun—instead of *the cloud*, talk about *cloud computing*, *cloud services*, or a specific service or functionality and what the customer can do with it. |
+| **cloud bursting, cloud-bursting** | It’s OK to use *cloud bursting* for technical audiences to mean when a private cloud taps into additional resources on the public cloud to meet a spike in demand. Define on the first mention.
Hyphenate *cloud-bursting* as an adjective preceding a noun, as in *cloud-bursting configuration*.
+| **cloud computing, cloud platform, cloud services** | Use *cloud computing*, not *the cloud*, to refer generally to the delivery of computing services over the internet.
Use *cloud platform* only in content for a technical audience, such as content about Azure.
Use *cloud services* to refer to the services provided via the cloud—such as servers, storage, databases, and software.
All terms are two words and lowercase. |
+| **cloud native, cloud-native** | In content for a technical audience, it’s OK to use *cloud native* to describe technologies that are built originally for the cloud and therefore optimized for cloud scale and performance.
Lowercase. Hyphenate *cloud-native* as an adjective preceding a noun, as in *cloud-native app*. Don’t hyphenate in other instances.
Don’t use *born in the cloud*, *cloud-born*, or similar phrases.
+| **cloud OS** | Don’t use. Use *platform as a service (PaaS)* instead.
+| **community cloud** | Never use. Use *hybrid cloud*, *private cloud*, or *hosted private cloud* instead. |
+| **content delivery network** | Lowercase when referring in general to a distributed network of servers that deliver web content. Always spell out; don’t use *CDN*. |
+| **cross-tenant** | Hyphenate in all positions. |
+| **edge, edge computing** | It’s OK to use these terms to refer to computing that shifts most data processing from a centralized system closer to a device or system that requires data quickly. Include short definitions of *the edge* and *edge computing* unless you’re sure your audience is familiar with the terms.
Lowercase.
Use *at the edge*—not *on the edge*—in references to edge computing.
+| **elastic computing, elastic cloud computing** | In general, avoid using these terms and instead talk about what the customer can do with this technology.
If your meaning is unclear without the terms, it’s OK to use them to talk about the use of cloud computing to quickly expand or decrease computer processing, memory, and storage resources to meet changing demands. Use *elastic cloud computing* when you need to clarify that cloud services are used.
Define these terms on the first mention unless you’re sure that your audience is familiar with them.
+| **hosted service** | Use this term to describe a service, an IT solution, or an application that's hosted by a service provider and made available to customers over the internet. |
+| **hosting provider, hoster** | It's OK to use *cloud hosting provider* and *web hosting provider* if you need to distinguish cloud service providers from web hosts. Don't use *hoster*. |
| **hybrid cloud** | OK to use for technical audiences who are comfortable with cloud technology, but define on the first mention. For other audiences, just talk about a hybrid model. |
-| **infrastructure as a service (IaaS)** | Use for technical audiences only.
Spell out on the first mention. After that, it's OK to use *IaaS.*
Don't capitalize as *IAAS.*
Don't hyphenate as a modifier, but include the abbreviated form in parentheses.
**Note** Don't compare IaaS with common utilities, such as power utilities. |
-| **IT as a service (ITaaS)** | Use for technical or business-decision-maker audiences only.
In content for a general audience, refer to the specific type of service, such as applying software updates, in a cloud-computing model.
Spell out on the first mention. After that, it's OK to use *ITaaS*.
Don't capitalize as *ITAAS*. |
-| **measured service** | Don't use to describe contractually defined and metered services (often per user or per hour). |
-| **Microsoft cloud platform, cloud platform** | Use for technical audiences only.
Always lowercase *cloud* and *platform*.
After the first mention, it's OK to use *cloud platform.*
Don't use *Cloud OS*. |
-| **Microsoft cloud services, Microsoft cloud** | Use to refer collectively to Microsoft business and enterprise products, services, and customer experiences that are delivered and consumed in real time over the internet. Don't use in content and communications for a consumer audience.
Always lowercase *cloud* and *services*.
After the first mention, it's OK to use *cloud services from Microsoft* or *cloud services offered by Microsoft.* |
+| **infrastructure as a service (IaaS)** | Use for technical audiences only.
It’s OK to use *IaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *IAAS.*
Don't hyphenate as a modifier. |
+| **IT as a service (ITaaS)** | Use for technical or business-decision-maker audiences only.
In content for a general audience, refer to the specific type of service, such as applying software updates, in a cloud-computing model.
It’s OK to use *ITaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *ITAAS*.
Don't hyphenate as a modifier. |
+| **the Microsoft cloud** | Use this term to describe the entire Microsoft cloud platform—not just Azure, but also the cloud on which all Microsoft cloud offerings run, including Dynamics 365, Microsoft Power Platform, and Microsoft 365.
When used in this meaning, *Microsoft Cloud* is capitalized.
Include the article (*the*) before *Microsoft Cloud*.
It’s OK to add a modifier between *the* and *Microsoft Cloud*—for example, “the trusted Microsoft Cloud.” |
+| **multicloud** | It's OK to use *multicloud* in content for technical audiences to refer to the use of multiple cloud-computing services from more than one cloud provider (including private and public clouds), in a heterogeneous environment.
One word, no hyphen. |
+| **multitenant, multitenancy** | It's OK to use these terms in content for a technical audience, but in content for a general audience, try to use friendlier language—for example, say *services used by multiple tenants* rather than *multitenant services*.
One word, no hyphen. |
| **on-premises, off-premises** | Hyphenate in all positions.
*Premises* is plural. Don't use *on-premise*, *off-premise*.
Don't use *on-premises cloud* or *off-premises cloud.* |
-| **platform as a service (PaaS)** | Use for technical audiences only.
Spell out on the first mention. After that, it's OK to use *PaaS*.
Don't capitalize as *PAAS*.
Don't hyphenate as a modifier, but include the abbreviated form in parentheses. |
-| **private cloud, hosted private cloud, public cloud** | Define these terms on the first mention. |
-| **service-oriented architecture** | Hyphenate.
Spell out on the first mention. After that, it's OK to use the acronym *SOA*. |
-| **software as a service (SaaS)** | Spell out on the first mention. After that, it's OK to use *SaaS* with technology industry audiences.
Don't capitalize as *SAAS*.
Don't hyphenate as a modifier, but include the abbreviated form in parentheses. |
+| **platform as a service (PaaS)** | Use for technical audiences only.
It’s OK to use *PaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *PAAS*.
Don't hyphenate as a modifier. |
+| **private cloud, hosted private cloud** | Define these terms on the first mention. |
+| **serverless** | One word, no hyphen. |
+| **software as a service (SaaS)** | It’s OK to use *SaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *SAAS*.
Don't hyphenate as a modifier. |
From 29e7a3a0818c321d40e6426892a367da06dcd11e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 15 Dec 2021 14:48:54 -0600
Subject: [PATCH 161/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 2c3c52c1..003ea944 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,6 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| December 9, 2021 | [Cloud-computing terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
| December 9, 2021 | [SQL, SQL server](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
From d6f35bc1b89eb01008f418a5e277b471b259b1e8 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Wed, 15 Dec 2021 14:49:09 -0600
Subject: [PATCH 162/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 003ea944..122fe347 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -14,7 +14,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| December 9, 2021 | [Cloud-computing terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
+| December 15, 2021 | [Cloud-computing terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
| December 9, 2021 | [SQL, SQL server](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
From a25f83148a6aa78c9f87021267816a4104a28b8e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 14 Jan 2022 09:53:08 -0600
Subject: [PATCH 163/486] Update cloud-computing-terms.md
---
.../term-collections/cloud-computing-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
index 4b6b98e6..1f23d28d 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
@@ -38,7 +38,7 @@ information about creating new terms or using emerging terminology, see [Use tec
| **hybrid cloud** | OK to use for technical audiences who are comfortable with cloud technology, but define on the first mention. For other audiences, just talk about a hybrid model. |
| **infrastructure as a service (IaaS)** | Use for technical audiences only.
It’s OK to use *IaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *IAAS.*
Don't hyphenate as a modifier. |
| **IT as a service (ITaaS)** | Use for technical or business-decision-maker audiences only.
In content for a general audience, refer to the specific type of service, such as applying software updates, in a cloud-computing model.
It’s OK to use *ITaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.
Don't capitalize as *ITAAS*.
Don't hyphenate as a modifier. |
-| **the Microsoft cloud** | Use this term to describe the entire Microsoft cloud platform—not just Azure, but also the cloud on which all Microsoft cloud offerings run, including Dynamics 365, Microsoft Power Platform, and Microsoft 365.
When used in this meaning, *Microsoft Cloud* is capitalized.
Include the article (*the*) before *Microsoft Cloud*.
It’s OK to add a modifier between *the* and *Microsoft Cloud*—for example, “the trusted Microsoft Cloud.” |
+| **the Microsoft Cloud** | Use this term to describe the entire Microsoft cloud platform—not just Azure, but also the cloud on which all Microsoft cloud offerings run, including Dynamics 365, Microsoft Power Platform, and Microsoft 365.
When used in this meaning, *Microsoft Cloud* is capitalized.
Include the article (*the*) before *Microsoft Cloud*.
It’s OK to add a modifier between *the* and *Microsoft Cloud*—for example, “the trusted Microsoft Cloud.” |
| **multicloud** | It's OK to use *multicloud* in content for technical audiences to refer to the use of multiple cloud-computing services from more than one cloud provider (including private and public clouds), in a heterogeneous environment.
One word, no hyphen. |
| **multitenant, multitenancy** | It's OK to use these terms in content for a technical audience, but in content for a general audience, try to use friendlier language—for example, say *services used by multiple tenants* rather than *multitenant services*.
One word, no hyphen. |
| **on-premises, off-premises** | Hyphenate in all positions.
*Premises* is plural. Don't use *on-premise*, *off-premise*.
**Example** Select **Xbox** .
+When referring to an icon, use bold formatting for the icon name. In instructions, use the name of the icon and its image, but don't use the word *icon*.
**Example** Select **Xbox** .
It's OK to use the word *icon:*
@@ -28,4 +29,4 @@ It's OK to use the word *icon:*
- In discussions about the icon itself.
- When you need to differentiate between the Start icon and the Start button (a rare occurrence).
-**Example** Most apps have their own settings. Look for this icon  in the app.
+**Example** Most apps have their own settings. Look for this icon  in the app.
diff --git a/styleguide/a-z-word-list-term-collections/m/master-slave.md b/styleguide/a-z-word-list-term-collections/m/master-slave.md
index 6467b8f4..585bc5d4 100644
--- a/styleguide/a-z-word-list-term-collections/m/master-slave.md
+++ b/styleguide/a-z-word-list-term-collections/m/master-slave.md
@@ -1,5 +1,6 @@
---
title: master/slave, master/subordinate - Microsoft Style Guide
+description: Describes the master and slave terms as needing to be replaced by the primary and secondary, principal and agent, controller and worker terms in content.
author: pallep
ms.author: pallep
ms.date: 08/04/2020
diff --git a/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md b/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
index e72ef6d1..2a36f986 100644
--- a/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
+++ b/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
@@ -1,5 +1,6 @@
---
title: Maximize button, maximize - Microsoft Style Guide
+description: Describes how to refer to the maximize button and maximizing screens in content and provides examples of referring to maximizing screens in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -16,4 +17,4 @@ It's OK to use *maximize* as a verb.
**Examples**
Select the **Maximize** button.
To fill the screen, maximize the window.
-Select .
+Select .
diff --git a/styleguide/a-z-word-list-term-collections/m/minimize-button-minimize.md b/styleguide/a-z-word-list-term-collections/m/minimize-button-minimize.md
index 26405fad..8cabe7b8 100644
--- a/styleguide/a-z-word-list-term-collections/m/minimize-button-minimize.md
+++ b/styleguide/a-z-word-list-term-collections/m/minimize-button-minimize.md
@@ -1,5 +1,6 @@
---
title: Minimize button, minimize - Microsoft Style Guide
+description: Describes how to refer to the minimize button and minimizing screens in content and provides examples of referring to minimizing screens in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -15,4 +16,4 @@ It's OK to use *minimize* as a verb.
**Examples**
Select the **Minimize** button.
-Select .
+Select .
diff --git a/styleguide/a-z-word-list-term-collections/m/multifactor-authentication.md b/styleguide/a-z-word-list-term-collections/m/multifactor-authentication.md
index e427822c..d8e9dac1 100644
--- a/styleguide/a-z-word-list-term-collections/m/multifactor-authentication.md
+++ b/styleguide/a-z-word-list-term-collections/m/multifactor-authentication.md
@@ -1,5 +1,6 @@
---
title: multifactor authentication- Microsoft Style Guide
+description: Describes when to use the term multifactor authentication and clarifies that this term must not be hyphenated nor abbreviated.
author: mbellthomson
ms.author: mbellthomson
ms.date: 03/30/2020
diff --git a/styleguide/a-z-word-list-term-collections/p/parent-child.md b/styleguide/a-z-word-list-term-collections/p/parent-child.md
index 16a5ab58..93ee1cb7 100644
--- a/styleguide/a-z-word-list-term-collections/p/parent-child.md
+++ b/styleguide/a-z-word-list-term-collections/p/parent-child.md
@@ -1,5 +1,6 @@
---
title: parent/child - Microsoft Style Guide
+description: Describes when to use the parent and child terms in content and provides a link to an article about the master and slave terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/phone.md b/styleguide/a-z-word-list-term-collections/p/phone.md
index cad711f8..89fdae73 100644
--- a/styleguide/a-z-word-list-term-collections/p/phone.md
+++ b/styleguide/a-z-word-list-term-collections/p/phone.md
@@ -1,5 +1,6 @@
---
title: phone, phone number - Microsoft Style Guide
+description: Describes how to refer to phone numbers in content and provides additional articles that discuss referring and formatting phone numbers in content.
author: pallep
ms.author: pallep
ms.date: 05/13/2022
@@ -15,5 +16,5 @@ As a UI label, use *Phone*, not *Phone number*.
For information about referring to mobile phones, see [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md).
-For information about how to format phone numbers, see [Numbers](https://docs.microsoft.com/en-us/style-guide/numbers).
+For information about how to format phone numbers, see [Numbers](https://docs.microsoft.com/style-guide/numbers).
diff --git a/styleguide/a-z-word-list-term-collections/p/pin-unpin.md b/styleguide/a-z-word-list-term-collections/p/pin-unpin.md
index 87a1c5aa..f04e3b14 100644
--- a/styleguide/a-z-word-list-term-collections/p/pin-unpin.md
+++ b/styleguide/a-z-word-list-term-collections/p/pin-unpin.md
@@ -1,5 +1,6 @@
---
title: pin, unpin - Microsoft Style Guide
+description: Describes how to implement the pin and unpin terms in content and provides examples of using the pin and unpin terms in content.
author: pallep
ms.author: pallep
ms.date: 05/9/2018
@@ -17,7 +18,7 @@ Pin important messages to the top of the message list, and unpin them when you'r
**Pin apps to Start**
-1. Select the **Start**  button, and then select **All apps**.
+1. Select the **Start**  button, and then select **All apps**.
2. Press and hold (or right-click) the app you want to pin.
diff --git a/styleguide/a-z-word-list-term-collections/s/slider.md b/styleguide/a-z-word-list-term-collections/s/slider.md
index e0233057..40b8dc6b 100644
--- a/styleguide/a-z-word-list-term-collections/s/slider.md
+++ b/styleguide/a-z-word-list-term-collections/s/slider.md
@@ -1,5 +1,6 @@
---
title: slider - Microsoft Style Guide
+description: Describes how to refer to slider user interface elements and provides an example of referring to a slider in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -16,7 +17,7 @@ you need to describe the UI element used to set a value on a continuous
range of possible values, such as screen brightness, mouse-click speed,
or volume.
-
+
In content for developers, it's OK to refer to a slider as a *trackbar control*.
diff --git a/styleguide/a-z-word-list-term-collections/s/spin-box.md b/styleguide/a-z-word-list-term-collections/s/spin-box.md
index c9ed60ea..92b59986 100644
--- a/styleguide/a-z-word-list-term-collections/s/spin-box.md
+++ b/styleguide/a-z-word-list-term-collections/s/spin-box.md
@@ -1,5 +1,6 @@
---
title: spin box - Microsoft Style Guide
+description: Describes how to refer to a spin box user interface element in content and provides an example of referring to the spin box in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -13,7 +14,7 @@ It's OK to use *spin box* in
content for a technical audience to describe a control that users can
use to move, or spin, through a fixed set of values, such as dates.
-
+
For a general audience, just discuss what the customer needs to do. If you
need to refer to the control, refer to a spin box by its label.
diff --git a/styleguide/a-z-word-list-term-collections/s/split-bar-split-box.md b/styleguide/a-z-word-list-term-collections/s/split-bar-split-box.md
index fd3f8021..5c76552e 100644
--- a/styleguide/a-z-word-list-term-collections/s/split-bar-split-box.md
+++ b/styleguide/a-z-word-list-term-collections/s/split-bar-split-box.md
@@ -1,5 +1,6 @@
---
title: split bar, split box - Microsoft Style Guide
+description: Describes that the split bar and split box user interface element can be referred to as a split bar and split box in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -9,6 +10,6 @@ ms.prod: non-product-specific
# split bar, split box
-
+
It's OK to use *split bar* and *split box* in content for all audiences.
diff --git a/styleguide/a-z-word-list-term-collections/s/start-button-start-menu.md b/styleguide/a-z-word-list-term-collections/s/start-button-start-menu.md
index c4481092..83a1f089 100644
--- a/styleguide/a-z-word-list-term-collections/s/start-button-start-menu.md
+++ b/styleguide/a-z-word-list-term-collections/s/start-button-start-menu.md
@@ -1,5 +1,6 @@
---
title: Start button, Start menu - Microsoft Style Guide
+description: Describes how to refer to the Start button and Start menu in content and provides an example of referring to the Start button in content.
author: pallep
ms.author: pallep
ms.date: 09/21/2019
@@ -16,8 +17,7 @@ Don't refer to the Start button as the *Windows Start button*.
Don't include the word *button* unless it's necessary for clarity. If you do, *button* is lowercase.
-If possible, to help customers locate the button, include the Start graphic 
-in references to the Start button.
+If possible, to help customers locate the button, include the Start graphic :::image type="icon" source="media/start-button-start-menu/967781121.png"::: in references to the Start button.
**Example**
-You'll find the Start  button on the taskbar.
+You'll find the Start :::image type="icon" source="media/start-button-start-menu/967781121.png"::: button on the taskbar.
diff --git a/styleguide/a-z-word-list-term-collections/s/status-bar.md b/styleguide/a-z-word-list-term-collections/s/status-bar.md
index 231bb833..a04f69e1 100644
--- a/styleguide/a-z-word-list-term-collections/s/status-bar.md
+++ b/styleguide/a-z-word-list-term-collections/s/status-bar.md
@@ -1,5 +1,6 @@
---
title: status bar - Microsoft Style Guide
+description: Describes how to refer to a status bar in content and provides an example of referring to a status bar in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -14,9 +15,9 @@ to the area at the bottom of a document window that shows the
status of a document and other information, such as the meaning of a
command. Messages appear *on,* not *in,* the status bar.
-
+
-
+
**Example**
The page number is displayed on the status bar.
diff --git a/styleguide/a-z-word-list-term-collections/s/symbol.md b/styleguide/a-z-word-list-term-collections/s/symbol.md
index 453efeb0..159228cd 100644
--- a/styleguide/a-z-word-list-term-collections/s/symbol.md
+++ b/styleguide/a-z-word-list-term-collections/s/symbol.md
@@ -1,5 +1,6 @@
---
title: symbol - Microsoft Style Guide
+description: Describes how to refer to various graphic or special characters in content and provides examples of referring to symbols in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -26,7 +27,7 @@ Follow these guidelines when discussing symbols:
- For
UI elements, such as buttons, you can use a graphic of the button by
itself after it has been named once or if selecting it displays a
- definition. **Examples** Select the **Minimize** button (). Select .
+ definition. **Examples** Select the **Minimize** button (). Select .
- Write out the plurals of symbols, showing the use in parentheses. Don't add *s* or *'s* to a symbol. **Example** Enter two backslashes (\\\\) to show a network connection.
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/ai-bot-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/ai-bot-terms.md
index 8c323c39..b742a0b3 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/ai-bot-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/ai-bot-terms.md
@@ -1,5 +1,6 @@
---
title: AI and bot terms - Microsoft Style Guide
+description: Describes how to refer to various terms relating to AI and bot technology and provides a table that outlines usage and example of various AI-related terms.
author: pallep
ms.author: pallep
ms.date: 02/21/2019
@@ -22,7 +23,7 @@ Before you invent a term, make sure a suitable term doesn't already exist. For m
| **bot, chatbot, virtual agent** | Use *bot* to refer to an app that performs automated tasks or engages with humans through a conversational interface.
If necessary, it's OK to use *chatbot* to clarify that the bot uses conversation to interact with the customer or *virtual agent* if the bot provides customer or technical support. After that, use *bot.*
Never refer to Cortana as a *bot, chatbot,* or *virtual agent.* Use *personal digital assistant* instead. |
| **conversation as a platform (CaaP)** | Don't use in content for a general audience.
OK to use if it's necessary to refer to the computing model in which two or more people or other entities exchange messages. Define the term on the first use, if necessary, to make sure the meaning is clear to your audience.
Spell out *conversation as a platform* whenever possible. If the term appears often, it's OK to use *CaaP* after the abbreviation is introduced in parentheses. Don't capitalize as *CAAP.*
Don't hyphenate *conversation as a platform* when used as a modifier. |
| **conversational user interface (CUI)** | Avoid the term in customer-facing communications.
OK to use if it's necessary to refer to a computing model where people interact with a system in a conversational manner, using text or voice input. Define the term on the first use, if necessary, to make sure the meaning is clear to your audience.
Spell out *conversational user interface* or *conversational UI* on the first use. Use *CUI* after the abbreviation is introduced in parentheses. |
-| **intelligent, intelligence, intelligent technology** | For all audiences and in most content, use *intelligent* or *intelligence* to describe or talk about the benefits of AI.
In UI, use *intelligent technology* to describe the underlying technology that powers AI features.
Don't use *smart technology.*
**Examples** To help people do their best work, Microsoft is making AI available to everyone by building intelligent features into our core products. Enhance your sales performance and planning with intelligent applications like Microsoft Dynamics 365 AI for Sales. From document translation to intelligent threat detection, AI is enhancing the productivity of more than 120 million commercial Office 365 users.  |
+| **intelligent, intelligence, intelligent technology** | For all audiences and in most content, use *intelligent* or *intelligence* to describe or talk about the benefits of AI.
In UI, use *intelligent technology* to describe the underlying technology that powers AI features.
Don't use *smart technology.*
**Examples** To help people do their best work, Microsoft is making AI available to everyone by building intelligent features into our core products. Enhance your sales performance and planning with intelligent applications like Microsoft Dynamics 365 AI for Sales. From document translation to intelligent threat detection, AI is enhancing the productivity of more than 120 million commercial Office 365 users.  |
| **Microsoft AI** | Use only to refer to the initiative that Microsoft is undertaking to accelerate AI capabilities and infuse intelligence into our offerings.
Microsoft AI isn't a technology, feature, product, or service. Don't say things like "Powered by Microsoft AI." Don't spell out *artificial intelligence* in references to Microsoft AI. |
| **personal digital assistant** | Use to refer to a type of bot that has a name, a semblance of a personality, knowledge of a customer's needs and preferences, and the ability to act on those needs and preferences.
Use instead of *agent, virtual assistant,* or *intelligent personal assistant* to refer to Cortana. |
| **social chatbot, relationship chatbot** | Use instead of *emotional chatbot* or *personified chatbot* to refer to a chatbot that people have conversations with for entertainment. Social chatbots often have a name and persona. Zo, Xiaoice, and Rinna are the Microsoft social chatbots. |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
index ea97f04e..ccbe4cb4 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
@@ -1,5 +1,6 @@
---
title: Mouse and mouse interaction terms - Microsoft Style Guide
+description: Describes how to refer the mouse and mouse interaction and provides a table that outlines the usage of various mouse-related terms.
author: pallep
ms.author: pallep
ms.date: 9/21/2019
@@ -48,6 +49,6 @@ of the word *pointer*—use both.
|**Term**|**Usage**|
|---|---|
|**busy pointer**|Use to describe the pointer when it consists only of an activity indicator.|
-|**double-headed arrow**|Use to describe how the pointer looks over a split line (). Don't use *double-headed arrow* as a name for the pointer. **Example** When the pointer becomes a , drag the pointer to move the split line.|
+|**double-headed arrow**|Use to describe how the pointer looks over a split line (:::image type="icon" source="media/mouse-mouse-interaction-terms/1502439723.png":::). Don't use *double-headed arrow* as a name for the pointer. **Example** When the pointer becomes a :::image type="icon" source="media/mouse-mouse-interaction-terms/1502439723.png":::, drag the pointer to move the split line.|
|**pointer**|Use to refer to the pointer on the screen. Use *cursor* only for a technical audience or when it's necessary to describe the point where text or graphics will be inserted. Don't use *insertion point*.|
|**working in background pointer**|Use to describe the pointer when it consists of both the pointer and an activity indicator.|
diff --git a/styleguide/a-z-word-list-term-collections/w/whitelist.md b/styleguide/a-z-word-list-term-collections/w/whitelist.md
index f4d06ce8..b49441b7 100644
--- a/styleguide/a-z-word-list-term-collections/w/whitelist.md
+++ b/styleguide/a-z-word-list-term-collections/w/whitelist.md
@@ -1,5 +1,6 @@
---
title: whitelist - Microsoft Style Guide
+description: Describes process of using the term allowlist in place of the whitelist in content and provides examples of using the term allowlist in content.
author: pallep
ms.author: pallep
ms.date: 1/15/2021
diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md
index 5a89646c..2ab93456 100644
--- a/styleguide/bias-free-communication.md
+++ b/styleguide/bias-free-communication.md
@@ -1,5 +1,6 @@
---
title: Bias-free communication - Microsoft Style Guide
+description: Describes Microsoft's prioritization of inclusive language and communication being used in content and provides terms to use and avoid in all content.
author: pallep
ms.author: pallep
ms.date: 08/25/2021
diff --git a/styleguide/global-communications/currency.md b/styleguide/global-communications/currency.md
index b955f1e2..9c7be117 100644
--- a/styleguide/global-communications/currency.md
+++ b/styleguide/global-communications/currency.md
@@ -1,5 +1,6 @@
---
title: Currency - Microsoft Style Guide
+description: Outlines various currency names, outlines how to reference specific monetary amounts through using currency codes.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -14,12 +15,11 @@ ms.prod: non-product-specific
In general, lowercase the names of currencies, but capitalize the reference to the country or region.
**Examples** US dollar Canadian dollar Hong Kong SAR dollar Brazilian real South African rand Pricing through the Microsoft Online Subscription Program is shown in US dollars.
-In
-a structured list, for example a table that compares available pricing
+In a structured list, for example a table that compares available pricing
options, it's OK to capitalize the name of the currency.
**Example**
-
+
## Specific monetary amounts
diff --git a/styleguide/procedures-instructions/describing-interactions-with-ui.md b/styleguide/procedures-instructions/describing-interactions-with-ui.md
index dd3c16c3..acd698fe 100644
--- a/styleguide/procedures-instructions/describing-interactions-with-ui.md
+++ b/styleguide/procedures-instructions/describing-interactions-with-ui.md
@@ -1,5 +1,6 @@
---
title: Describing interactions with UI - Microsoft Style Guide
+description: Describes how to refer to various interactions with UI and provides a table that outlines various verbs to use and examples of how to use them in content.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
@@ -22,9 +23,9 @@ input method. Don't use input-specific verbs, such as *click* or *swipe*. Instea
| **Open** |
Apps and programs
Blades
File Explorer
Files and folders
Shortcut menus
Use for websites and webpages only when necessary to match the UI. Otherwise, use go to.
Don't use for commands and menus.
|
Open Photos.
Open the Reader app.
Select Users + groups to open the blade.
Open the Filename file.
To open the document in Outline view, select View > Outline.
In WindowName, open the shortcut menu for ItemName.
|
| **Close** |
Apps and programs
Blades
Dialog boxes
Files and folders
Notifications and alerts
Tabs
The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with stop responding.)
|
Close the Alarms app.
Close Excel.
Close the blade.
Close the Users + groups blade.
Save and close the document.
Closing Excel also closes all open worksheets.
|
| **Leave** | Websites and webpages | Select **Submit** to complete the survey and leave this page. |
-| **Go to** |
Opening a menu.
Going to a tab or another particular place in the UI.
Going to a website or webpage.
It's OK to use On theXXXtab if the instruction is brief and continues immediately.
|
Go to Search , enter the word settings, and then select Settings.
Go to File, and then select Close.
On the ribbon, go to the Design tab.
Go to the Deploy tab. In the Configuration list …
On the Deploy tab, in the Configuration list …
Go to Example.com to register.
|
+| **Go to** |
Opening a menu.
Going to a tab or another particular place in the UI.
Going to a website or webpage.
It's OK to use On theXXXtab if the instruction is brief and continues immediately.
|
Go to Search :::image type="icon" source="media/describing-interactions-with-ui/721771267.png":::, enter the word settings, and then select Settings.
Go to File, and then select Close.
On the ribbon, go to the Design tab.
Go to the Deploy tab. In the Configuration list …
On the Deploy tab, in the Configuration list …
Go to Example.com to register.
|
| **Select** | Instructing the customer to select a specific item, including:
Selecting an option, such as a button.
Selecting a checkbox.
Selecting a value from a list box.
Selecting link text to go to a link.
Selecting an item on a menu or shortcut menu.
Selecting an item from a gallery.
Selecting keys and keyboard shortcuts. (Document keyboard shortcuts only if they're the most likely way the customer will accomplish a task or as an alternative input method, usually in a separate keyboard shortcuts article.)
|
Select the Modify button.
For Alignment, select Left.
Select the text, open the shortcut menu, and then select Font.
Select Open in new tab.
Select the LinkName link.
Select **F5**.
Select **Shift+Enter**.
Select **Ctrl+Alt+Delete**.
|
-| **Select and hold, select and hold (or right-click)** | Use to describe pressing and holding an element in the UI. It's OK to use *right-click* with *select and hold* when the instruction isn't specific to touch devices. |
To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.
Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.
Select and hold (or right-click) the **Start** button, and then select **Device Manager**.
|
+| **Select and hold, select and hold (or right-click)** | Use to describe pressing and holding an element in the UI. It's OK to use *right-click* with *select and hold* when the instruction isn't specific to touch devices. |
To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.
Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.
Select and hold (or right-click) the **Start** :::image type="icon" source="media/describing-interactions-with-ui/967781121.png"::: button, and then select **Device Manager**.
|
| **>** | Use a greater-than symbol (>) to separate sequential steps.
Only use this approach when there's a clear and obvious path through the UI and the selection method is the same for each step. For example, don't mix things that require opening, selecting, and choosing.
Don't bold the greater-than symbol. Include a space before and after the symbol. | Select **Accounts > Other accounts > Add an account**. |
| **Clear** | Clearing the selection from a checkbox. | Clear the **Header row** checkbox. |
| **Choose** | Choosing an option, based on the customer's preference or desired outcome. | On the **Font** tab, choose the effects you want. |
diff --git a/styleguide/procedures-instructions/illustrating-network-traffic-flows.md b/styleguide/procedures-instructions/illustrating-network-traffic-flows.md
index 9af533a2..7fd8ea37 100644
--- a/styleguide/procedures-instructions/illustrating-network-traffic-flows.md
+++ b/styleguide/procedures-instructions/illustrating-network-traffic-flows.md
@@ -1,5 +1,6 @@
---
title: Illustrating network traffic flows - Microsoft Style Guide
+description: Describes how to illustrate network traffic flows and provides guidelines to follow and various examples of network flow descriptions.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -37,20 +38,20 @@ communication.
With both types of arrows, subsequent communication is two-way.
-
+
**Use line styles to distinguish different traffic flows.** Choose line colors that contrast with the image background
and are distinct when printed or viewed in black and white.
-
+
**Label specific network traffic.** If possible, overlay the label onto the line:
-
+
Otherwise, add the label as a callout:
-
+
## Represent security boundaries with solid vertical lines
@@ -60,7 +61,7 @@ that indicate network traffic flow across the vertical line. This
example shows firewalled and partitioned networks in Microsoft
Azure.
-
+
## Use standard network traffic syntax
diff --git a/styleguide/procedures-instructions/index.md b/styleguide/procedures-instructions/index.md
index 72c8e510..3c6dedaa 100644
--- a/styleguide/procedures-instructions/index.md
+++ b/styleguide/procedures-instructions/index.md
@@ -1,5 +1,6 @@
---
title: Procedures and instructions - Microsoft Style Guide
+description: Describes how to create procedures and instructions in content and provides examples of ways to communicate procedures and instructions in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -9,28 +10,27 @@ ms.prod: non-product-specific
# Procedures and instructions
-The
-best procedure is the one you don’t need. If the UI is crystal
+The best procedure is the one you don’t need. If the UI is crystal
clear and leads the customer through a task, a procedure
isn’t necessary. Start there.
Some tasks are more complex. When you need to provide a procedure, look for the clearest way to present it. That might be:
- A picture, an illustration, a poster, or an infographic
- 
+ 
- A video.
- 
+ 
- A one-sentence instruction.
- 
+ 
- A numbered
procedure, which might include pictures, videos, and links or
buttons that take customers where they need to go.
- 
+ 
When
a procedure is the best approach, use the guidelines in this
diff --git a/styleguide/procedures-instructions/writing-step-by-step-instructions.md b/styleguide/procedures-instructions/writing-step-by-step-instructions.md
index d8240266..d1227914 100644
--- a/styleguide/procedures-instructions/writing-step-by-step-instructions.md
+++ b/styleguide/procedures-instructions/writing-step-by-step-instructions.md
@@ -1,5 +1,6 @@
---
title: Writing step-by-step instructions - Microsoft Style Guide
+description: Describes process of writing step-by-step instructions and outlines processes with examples for complex and simple procedures.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -67,7 +68,7 @@ numbered list. For multiple-step procedures in numbered lists:
Several predefined sprints are listed under **Current** and **Future**. Actual sprint titles vary based on the [process template](https://msdn.microsoft.com/library/ms400752.aspx) used to create your team project. However, calendar dates haven’t been assigned.
2. To set the calendar dates, select the first sprint under **Current**, and select dates.
- 
+ 
## Single-step procedures
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index 4559d800..ceefb487 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -1,5 +1,6 @@
---
title: Colons - Microsoft Style Guide
+description: Describes how to use colons in various contexts including preceding lists, within sentences, in titles and headings, in UI, and when displaying clock time.
author: pallep
ms.author: pallep
ms.date: 03/03/2022
@@ -53,6 +54,6 @@ Don’t use colon when introducing lists of radio buttons or checkboxes.
## When displaying clock time
-Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms).
+Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](https://docs.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms).
**Example**
The meeting is scheduled for 1∶00 PM.
diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md
index 34a51d7c..f1c5583b 100644
--- a/styleguide/punctuation/dashes-hyphens/hyphens.md
+++ b/styleguide/punctuation/dashes-hyphens/hyphens.md
@@ -1,5 +1,6 @@
---
title: Hyphens - Microsoft Style Guide
+description: Describes how to use hyphens in various contexts in content including predicate adjectives, noun modifiers, compound nouns, prefixes, and more.
author: pallep
ms.author: pallep
ms.date: 05/20/2021
@@ -106,11 +107,20 @@ Avoid creating new words by adding prefixes to existing words. Rewrite to avoid
In general, don’t include a hyphen after the following prefixes unless omitting the hyphen could confuse the reader.
-| | | | | |
-| ------ | ----- | ------ | ---- | ----- |
-| auto- | exa- | mega- | pre- | tera- |
-| co- | giga- | micro- | re- | un- |
-| cyber- | kilo- | non- | sub- | |
+- auto-
+- co-
+- cyber-
+- exa-
+- giga-
+- kilo-
+- mega-
+- micro-
+- non-
+- pre-
+- re-
+- sub-
+- tera-
+- un-
Use a hyphen between a prefix and a stem word:
diff --git a/styleguide/punctuation/ellipses.md b/styleguide/punctuation/ellipses.md
index 504263c7..1fb70f36 100644
--- a/styleguide/punctuation/ellipses.md
+++ b/styleguide/punctuation/ellipses.md
@@ -1,5 +1,6 @@
---
title: Ellipses - Microsoft Style Guide
+description: Describes how to use ellipses in content, outlines situations where ellipses are allowed, and provides examples of how to implement ellipses into content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -36,7 +37,7 @@ In quoted material, use an ellipsis to indicate omitted text.
It’s OK to use an ellipsis in multiple-part callouts, especially with screenshots or graphics in documentation.
-
+
- Ensure that the path through the callouts is clear. Document each step.
From 6e57072b0212fa5d04b0c80045aefda618fd00d1 Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Wed, 25 May 2022 16:34:54 -0500
Subject: [PATCH 190/486] absolute link fix
---
styleguide/a-z-word-list-term-collections/p/phone.md | 2 +-
styleguide/punctuation/colons.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/p/phone.md b/styleguide/a-z-word-list-term-collections/p/phone.md
index 89fdae73..f4a1d8a2 100644
--- a/styleguide/a-z-word-list-term-collections/p/phone.md
+++ b/styleguide/a-z-word-list-term-collections/p/phone.md
@@ -16,5 +16,5 @@ As a UI label, use *Phone*, not *Phone number*.
For information about referring to mobile phones, see [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md).
-For information about how to format phone numbers, see [Numbers](https://docs.microsoft.com/style-guide/numbers).
+For information about how to format phone numbers, see [Numbers](/style-guide/numbers).
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index ceefb487..34988b8e 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -54,6 +54,6 @@ Don’t use colon when introducing lists of radio buttons or checkboxes.
## When displaying clock time
-Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](https://docs.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms).
+Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms).
**Example**
The meeting is scheduled for 1∶00 PM.
From ffb1eb6b73ebf077056aa9ecd7acb5053cb793f2 Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Wed, 25 May 2022 16:47:57 -0500
Subject: [PATCH 191/486] description fix
---
.../m/maximize-button-maximize.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md b/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
index 2a36f986..08ecff47 100644
--- a/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
+++ b/styleguide/a-z-word-list-term-collections/m/maximize-button-maximize.md
@@ -17,4 +17,4 @@ It's OK to use *maximize* as a verb.
**Examples**
Select the **Maximize** button.
To fill the screen, maximize the window.
-Select .
+Select .
From 9f5c0c392897545d1df53ffbbb5852e44049e3c4 Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Wed, 25 May 2022 17:27:49 -0500
Subject: [PATCH 192/486] added descriptions
---
styleguide/punctuation/periods.md | 3 ++-
styleguide/scannable-content/headings.md | 3 ++-
styleguide/scannable-content/pull-quotes.md | 3 ++-
styleguide/scannable-content/sidebars.md | 3 ++-
styleguide/welcome/index.md | 2 +-
styleguide/welcome/whats-new.md | 25 +++++++++++----------
6 files changed, 22 insertions(+), 17 deletions(-)
diff --git a/styleguide/punctuation/periods.md b/styleguide/punctuation/periods.md
index 185a4067..b1e812f7 100644
--- a/styleguide/punctuation/periods.md
+++ b/styleguide/punctuation/periods.md
@@ -1,5 +1,6 @@
---
title: Periods - Microsoft Style Guide
+description: Describes how to implement periods in content and provides example of how to use periods in headlines and in text of content.
author: pallep
ms.author: pallep
ms.date: 05/13/2022
@@ -15,7 +16,7 @@ titles, UI text, or simple lists (three or fewer words per item).
End all sentences with a period, even if they're only two words. Put one space, not two, after a period.
-For information about how to use periods in bulleted lists and numbered lists, see [Lists](https://docs.microsoft.com/en-us/style-guide/scannable-content/lists).
+For information about how to use periods in bulleted lists and numbered lists, see [Lists](/style-guide/scannable-content/lists).
**Headline example**
diff --git a/styleguide/scannable-content/headings.md b/styleguide/scannable-content/headings.md
index a23aeed1..3a6e0c08 100644
--- a/styleguide/scannable-content/headings.md
+++ b/styleguide/scannable-content/headings.md
@@ -1,5 +1,6 @@
---
title: Headings - Microsoft Style Guide
+description: Describes how to implement headings in content and outlines how to write, format, and use run-in headings and provides multiple example headings.
author: pallep
ms.author: pallep
ms.date: 07/24/2018
@@ -159,4 +160,4 @@ When you use bold formatting for run-in headings:
next to the style name. To create a new character style in a
document, select the characters, and then add the style.
- 
+ 
diff --git a/styleguide/scannable-content/pull-quotes.md b/styleguide/scannable-content/pull-quotes.md
index 65effe80..51bd1f3a 100644
--- a/styleguide/scannable-content/pull-quotes.md
+++ b/styleguide/scannable-content/pull-quotes.md
@@ -1,5 +1,6 @@
---
title: Pull quotes - Microsoft Style Guide
+description: Describes how to implement pull quotes in content and provides an example of how to include pull quotes in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -11,7 +12,7 @@ ms.prod: non-product-specific
Pull quotes are short sentences—usually a quote from someone important to the story, but sometimes just a short, interesting sentence—set off from body text to grab the reader’s attention.
-
+
Pull quotes
should be short—from a few words to a few lines. If the quote is
diff --git a/styleguide/scannable-content/sidebars.md b/styleguide/scannable-content/sidebars.md
index cb781cdb..5f58e2d1 100644
--- a/styleguide/scannable-content/sidebars.md
+++ b/styleguide/scannable-content/sidebars.md
@@ -1,5 +1,6 @@
---
title: Sidebars - Microsoft Style Guide
+description: Describes how to implement sidebars in content, specifically with longer articles or documents and provides an example of a sidebar.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -20,4 +21,4 @@ people read sidebars before or after the rest of the page, so don’t use
sidebars for information that should be read in sequence with the
main text.
-
+
diff --git a/styleguide/welcome/index.md b/styleguide/welcome/index.md
index 6fdbc388..b3d121fe 100644
--- a/styleguide/welcome/index.md
+++ b/styleguide/welcome/index.md
@@ -10,7 +10,7 @@ ms.prod: non-product-specific
# Welcome
-
+
## Make every word matter
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3684b465..d700278c 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -1,5 +1,6 @@
---
title: What's new? - Microsoft Style Guide
+description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
ms.date: 05/13/2022
@@ -14,18 +15,18 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| May 13, 2022 | [Lists](https://docs.microsoft.com/en-us/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
-| May 13, 2022 | [Periods](https://docs.microsoft.com/en-us/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
-| May 13, 2022 | [Numbers](https://docs.microsoft.com/en-us/style-guide/numbers) | Added new section on phone numbers.
-| May 13, 2022 | [phone, phone number](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
-| December 15, 2021 | [Cloud-computing terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
-| December 9, 2021 | [SQL, SQL server](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
-| August 26, 2021 | [multi-](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
-| August 26, 2021 | [touch-sensitive](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
-| August 25, 2021 | [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication) | Added inclusive language section.
-| August 12, 2021 | [colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
-| August 11, 2021 | [numbers](https://docs.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
-| August 10, 2021 | [date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
+| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
+| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
+| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
+| May 13, 2022 | [phone, phone number](/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
+| December 15, 2021 | [Cloud-computing terms](/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
+| December 9, 2021 | [SQL, SQL server](/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
+| August 26, 2021 | [multi-](/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
+| August 26, 2021 | [touch-sensitive](/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
+| August 25, 2021 | [Bias-free communication](/style-guide/bias-free-communication) | Added inclusive language section.
+| August 12, 2021 | [colons](/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
+| August 11, 2021 | [numbers](/style-guide/numbers) | Replaced colons with ratio symbols.
+| August 10, 2021 | [date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
From 48855014a6f56885ef7d4067529efa194f318b15 Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Wed, 25 May 2022 17:51:45 -0500
Subject: [PATCH 193/486] description fixes
---
styleguide/punctuation/periods.md | 2 +-
styleguide/scannable-content/headings.md | 2 +-
styleguide/scannable-content/pull-quotes.md | 4 ++--
styleguide/scannable-content/sidebars.md | 2 +-
styleguide/welcome/index.md | 2 +-
5 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/styleguide/punctuation/periods.md b/styleguide/punctuation/periods.md
index b1e812f7..46f0298d 100644
--- a/styleguide/punctuation/periods.md
+++ b/styleguide/punctuation/periods.md
@@ -1,6 +1,6 @@
---
title: Periods - Microsoft Style Guide
-description: Describes how to implement periods in content and provides example of how to use periods in headlines and in text of content.
+description: Describes how to implement periods in content and provides examples of how to use periods in headlines and in text of content.
author: pallep
ms.author: pallep
ms.date: 05/13/2022
diff --git a/styleguide/scannable-content/headings.md b/styleguide/scannable-content/headings.md
index 3a6e0c08..9bc71a83 100644
--- a/styleguide/scannable-content/headings.md
+++ b/styleguide/scannable-content/headings.md
@@ -1,6 +1,6 @@
---
title: Headings - Microsoft Style Guide
-description: Describes how to implement headings in content and outlines how to write, format, and use run-in headings and provides multiple example headings.
+description: Describes how to implement headings in content and outlines how to write, format, use run-in headings, and provides multiple example headings.
author: pallep
ms.author: pallep
ms.date: 07/24/2018
diff --git a/styleguide/scannable-content/pull-quotes.md b/styleguide/scannable-content/pull-quotes.md
index 51bd1f3a..9d522556 100644
--- a/styleguide/scannable-content/pull-quotes.md
+++ b/styleguide/scannable-content/pull-quotes.md
@@ -1,6 +1,6 @@
---
title: Pull quotes - Microsoft Style Guide
-description: Describes how to implement pull quotes in content and provides an example of how to include pull quotes in content.
+description: Describes how to implement pull quotes in content and provides an example of how to include pull quotes.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -12,7 +12,7 @@ ms.prod: non-product-specific
Pull quotes are short sentences—usually a quote from someone important to the story, but sometimes just a short, interesting sentence—set off from body text to grab the reader’s attention.
-
+
Pull quotes
should be short—from a few words to a few lines. If the quote is
diff --git a/styleguide/scannable-content/sidebars.md b/styleguide/scannable-content/sidebars.md
index 5f58e2d1..0b1f848b 100644
--- a/styleguide/scannable-content/sidebars.md
+++ b/styleguide/scannable-content/sidebars.md
@@ -21,4 +21,4 @@ people read sidebars before or after the rest of the page, so don’t use
sidebars for information that should be read in sequence with the
main text.
-
+
diff --git a/styleguide/welcome/index.md b/styleguide/welcome/index.md
index b3d121fe..b06f5a09 100644
--- a/styleguide/welcome/index.md
+++ b/styleguide/welcome/index.md
@@ -10,7 +10,7 @@ ms.prod: non-product-specific
# Welcome
-
+
## Make every word matter
From 8b0bdeba2ca559d1314aa141baebb97100a2aeb1 Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 09:21:27 -0700
Subject: [PATCH 194/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/d/deselect.md | 1 +
styleguide/a-z-word-list-term-collections/d/desktop.md | 1 +
.../d/destination-drive-destination-file.md | 1 +
styleguide/a-z-word-list-term-collections/d/destination.md | 1 +
.../a-z-word-list-term-collections/d/device-driver-driver.md | 1 +
styleguide/a-z-word-list-term-collections/d/device.md | 1 +
styleguide/a-z-word-list-term-collections/d/devops.md | 1 +
styleguide/a-z-word-list-term-collections/d/dial-up.md | 1 +
.../d/dialog-box-dialog-dialogue.md | 1 +
styleguide/a-z-word-list-term-collections/d/different.md | 1 +
styleguide/a-z-word-list-term-collections/d/dimmed.md | 1 +
styleguide/a-z-word-list-term-collections/d/direction-keys.md | 1 +
styleguide/a-z-word-list-term-collections/d/directory.md | 1 +
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 1 +
14 files changed, 14 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/deselect.md b/styleguide/a-z-word-list-term-collections/d/deselect.md
index 0a92f840..9e17b7c3 100644
--- a/styleguide/a-z-word-list-term-collections/d/deselect.md
+++ b/styleguide/a-z-word-list-term-collections/d/deselect.md
@@ -1,5 +1,6 @@
---
title: deselect - Microsoft Style Guide
+description: Describes guidelines to use 'deselect' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/desktop.md b/styleguide/a-z-word-list-term-collections/d/desktop.md
index c01889bb..c23baf55 100644
--- a/styleguide/a-z-word-list-term-collections/d/desktop.md
+++ b/styleguide/a-z-word-list-term-collections/d/desktop.md
@@ -1,5 +1,6 @@
---
title: desktop - Microsoft Style Guide
+description: Describes guidelines to use 'desktop' in Microsoft documents, and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md b/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
index 7d2f9426..7b1e1a14 100644
--- a/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
+++ b/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
@@ -1,5 +1,6 @@
---
title: destination drive, destination file - Microsoft Style Guide
+description: Defines guidelines for using 'destination drive' or 'destination file' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/destination.md b/styleguide/a-z-word-list-term-collections/d/destination.md
index aaaf1148..83ace4fc 100644
--- a/styleguide/a-z-word-list-term-collections/d/destination.md
+++ b/styleguide/a-z-word-list-term-collections/d/destination.md
@@ -1,5 +1,6 @@
---
title: destination - Microsoft Style Guide
+description: Describes guidelines to use 'destination' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/device-driver-driver.md b/styleguide/a-z-word-list-term-collections/d/device-driver-driver.md
index eb672ba6..eef70d0f 100644
--- a/styleguide/a-z-word-list-term-collections/d/device-driver-driver.md
+++ b/styleguide/a-z-word-list-term-collections/d/device-driver-driver.md
@@ -1,5 +1,6 @@
---
title: device driver, driver - Microsoft Style Guide
+description: Describes guidelines to use 'device driver' or 'driver' in Microsoft documents. In content for a general audience, define 'driver' on the first mention.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/device.md b/styleguide/a-z-word-list-term-collections/d/device.md
index 8480c871..0337d1a0 100644
--- a/styleguide/a-z-word-list-term-collections/d/device.md
+++ b/styleguide/a-z-word-list-term-collections/d/device.md
@@ -1,5 +1,6 @@
---
title: device - Microsoft Style Guide
+description: Defines guidelines for using 'device' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/devops.md b/styleguide/a-z-word-list-term-collections/d/devops.md
index d3ba1240..d8273a62 100644
--- a/styleguide/a-z-word-list-term-collections/d/devops.md
+++ b/styleguide/a-z-word-list-term-collections/d/devops.md
@@ -1,5 +1,6 @@
---
title: DevOps - Microsoft Style Guide
+description: Describes guidelines to use 'DevOps' in Microsoft Docs. Carefully note spelling and capitalization.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dial-up.md b/styleguide/a-z-word-list-term-collections/d/dial-up.md
index 538f3ec8..4a9413af 100644
--- a/styleguide/a-z-word-list-term-collections/d/dial-up.md
+++ b/styleguide/a-z-word-list-term-collections/d/dial-up.md
@@ -1,5 +1,6 @@
---
title: dial-up - Microsoft Style Guide
+description: Describes guidelines to use 'dial-up' in Microsoft documents. Only use dial-up as an adjective, and always hyphenate.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md b/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
index 991bf25f..f6b9e9ca 100644
--- a/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
+++ b/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
@@ -1,5 +1,6 @@
---
title: dialog box, dialog, dialogue - Microsoft Style Guide
+description: Describes guidelines to use 'dialog' in Microsoft documents, and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 03/31/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/different.md b/styleguide/a-z-word-list-term-collections/d/different.md
index 815820b0..3db694b3 100644
--- a/styleguide/a-z-word-list-term-collections/d/different.md
+++ b/styleguide/a-z-word-list-term-collections/d/different.md
@@ -1,5 +1,6 @@
---
title: different - Microsoft Style Guide
+description: Describes guidelines to use the word 'different' in Microsoft documents, and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dimmed.md b/styleguide/a-z-word-list-term-collections/d/dimmed.md
index 999bea8c..cf0ee17f 100644
--- a/styleguide/a-z-word-list-term-collections/d/dimmed.md
+++ b/styleguide/a-z-word-list-term-collections/d/dimmed.md
@@ -1,5 +1,6 @@
---
title: dimmed - Microsoft Style Guide
+description: Describes guidelines to use the word 'dimmed' in Microsoft documents, and provides correct examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/direction-keys.md b/styleguide/a-z-word-list-term-collections/d/direction-keys.md
index 1a6973bd..a8551b32 100644
--- a/styleguide/a-z-word-list-term-collections/d/direction-keys.md
+++ b/styleguide/a-z-word-list-term-collections/d/direction-keys.md
@@ -1,5 +1,6 @@
---
title: direction keys - Microsoft Style Guide
+description: Describes guidelines when writing about direction keys in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/directory.md b/styleguide/a-z-word-list-term-collections/d/directory.md
index f48b5a10..06c6daec 100644
--- a/styleguide/a-z-word-list-term-collections/d/directory.md
+++ b/styleguide/a-z-word-list-term-collections/d/directory.md
@@ -1,5 +1,6 @@
---
title: directory - Microsoft Style Guide
+description: Describes guidelines to use the word 'directory' in Microsoft documents, including instances where this word is appropriate or allowed.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index daf23fb8..b77f7488 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -1,5 +1,6 @@
---
title: disable, disabled - Microsoft Style Guide
+description: Describes guidelines to use 'disable' or 'disabled' in Microsoft documents, including instances where this word is appropriate or allowed.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 2d265685846313968e9605bce2f8346a9f6991fd Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 09:57:25 -0700
Subject: [PATCH 195/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/d/disc.md | 1 +
.../a-z-word-list-term-collections/d/disjoint-selection.md | 1 +
styleguide/a-z-word-list-term-collections/d/disk-resource.md | 1 +
styleguide/a-z-word-list-term-collections/d/disk-space.md | 1 +
styleguide/a-z-word-list-term-collections/d/disk.md | 1 +
.../d/display-adapter-display-driver.md | 1 +
styleguide/a-z-word-list-term-collections/d/display.md | 1 +
styleguide/a-z-word-list-term-collections/d/dns.md | 1 +
styleguide/a-z-word-list-term-collections/d/document.md | 1 +
styleguide/a-z-word-list-term-collections/d/domain.md | 1 +
styleguide/a-z-word-list-term-collections/d/dot-com.md | 1 +
styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md | 1 +
styleguide/a-z-word-list-term-collections/d/double-buffering.md | 1 +
.../d/double-click-double-clicking.md | 1 +
styleguide/a-z-word-list-term-collections/d/downgrade.md | 1 +
styleguide/a-z-word-list-term-collections/d/download.md | 1 +
16 files changed, 16 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/disc.md b/styleguide/a-z-word-list-term-collections/d/disc.md
index 96b43fa6..5d25f48e 100644
--- a/styleguide/a-z-word-list-term-collections/d/disc.md
+++ b/styleguide/a-z-word-list-term-collections/d/disc.md
@@ -1,5 +1,6 @@
---
title: disc - Microsoft Style Guide
+description: To find guidelines to use 'disc' in Microsoft documents, see the Computer and device term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md b/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
index 4f185d7c..c4723836 100644
--- a/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
+++ b/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
@@ -1,5 +1,6 @@
---
title: disjoint selection - Microsoft Style Guide
+description: Describes guidelines to use 'disjoint selection' in Microsoft documents, and provides alternatives.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-resource.md b/styleguide/a-z-word-list-term-collections/d/disk-resource.md
index 2db68615..bad7e7b6 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-resource.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-resource.md
@@ -1,5 +1,6 @@
---
title: disk resource - Microsoft Style Guide
+description: In Microsoft documents, use 'disk resource' to refer to a disk or part of a disk shared on a server.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-space.md b/styleguide/a-z-word-list-term-collections/d/disk-space.md
index 4e1f78f7..1f14f377 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-space.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-space.md
@@ -1,5 +1,6 @@
---
title: disk space - Microsoft Style Guide
+description: In Microsoft documents, use 'disk space' instead of 'storage' or 'memory' to refer to available capacity on a disk.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disk.md b/styleguide/a-z-word-list-term-collections/d/disk.md
index 58fd40c8..f71e4cbd 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk.md
@@ -1,5 +1,6 @@
---
title: disk - Microsoft Style Guide
+description: For guidelines to use 'disk' in Microsoft documents, refer to the Computer and device term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md b/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
index e50ae0ae..a22de8fa 100644
--- a/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
+++ b/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
@@ -1,5 +1,6 @@
---
title: display adapter, display driver - Microsoft Style Guide
+description: Describes guidelines to use 'display adapter' or 'display driver' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/display.md b/styleguide/a-z-word-list-term-collections/d/display.md
index 317eb1cb..d74b5597 100644
--- a/styleguide/a-z-word-list-term-collections/d/display.md
+++ b/styleguide/a-z-word-list-term-collections/d/display.md
@@ -1,5 +1,6 @@
---
title: display - Microsoft Style Guide
+description: To see guidelines to use 'display' in Microsoft documents, see the Computer and device term collection.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/d/dns.md b/styleguide/a-z-word-list-term-collections/d/dns.md
index 67bb477e..bd22ab91 100644
--- a/styleguide/a-z-word-list-term-collections/d/dns.md
+++ b/styleguide/a-z-word-list-term-collections/d/dns.md
@@ -1,5 +1,6 @@
---
title: DNS - Microsoft Style Guide
+description: Describes guidelines to use 'DNS' in Microsoft documents, and provides alternate examples. Includes capitalization guidelines for compound phrases that include 'DNS.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/document.md b/styleguide/a-z-word-list-term-collections/d/document.md
index 57e2b304..2259be88 100644
--- a/styleguide/a-z-word-list-term-collections/d/document.md
+++ b/styleguide/a-z-word-list-term-collections/d/document.md
@@ -1,5 +1,6 @@
---
title: document - Microsoft Style Guide
+description: Describes guidelines to use 'document' in Microsoft documents, and provides alternate correct examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/domain.md b/styleguide/a-z-word-list-term-collections/d/domain.md
index 30d7b20b..e3274b5b 100644
--- a/styleguide/a-z-word-list-term-collections/d/domain.md
+++ b/styleguide/a-z-word-list-term-collections/d/domain.md
@@ -1,5 +1,6 @@
---
title: domain - Microsoft Style Guide
+description: Describes guidelines to use 'domain' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dot-com.md b/styleguide/a-z-word-list-term-collections/d/dot-com.md
index 01b2eca4..927fd6b8 100644
--- a/styleguide/a-z-word-list-term-collections/d/dot-com.md
+++ b/styleguide/a-z-word-list-term-collections/d/dot-com.md
@@ -1,5 +1,6 @@
---
title: dot-com - Microsoft Style Guide
+description: Describes guidelines to use 'deselect' in Microsoft documents - do not use 'dot-com' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md b/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
index 8c6209d4..0ce300ef 100644
--- a/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
+++ b/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
@@ -1,5 +1,6 @@
---
title: dotted rectangle - Microsoft Style Guide
+description: Describes guidelines to use 'dotted rectangle' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/double-buffering.md b/styleguide/a-z-word-list-term-collections/d/double-buffering.md
index 16c875ee..5b973c55 100644
--- a/styleguide/a-z-word-list-term-collections/d/double-buffering.md
+++ b/styleguide/a-z-word-list-term-collections/d/double-buffering.md
@@ -1,5 +1,6 @@
---
title: double buffering - Microsoft Style Guide
+description: Describes guidelines to use 'double buffering' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/double-click-double-clicking.md b/styleguide/a-z-word-list-term-collections/d/double-click-double-clicking.md
index dddcd70f..bac1a4a2 100644
--- a/styleguide/a-z-word-list-term-collections/d/double-click-double-clicking.md
+++ b/styleguide/a-z-word-list-term-collections/d/double-click-double-clicking.md
@@ -1,5 +1,6 @@
---
title: double-click, double-clicking - Microsoft Style Guide
+description: To see guidelines to use 'double-click' or 'double-clicking' in Microsoft documents, see the Mouse and mouse interaction term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/downgrade.md b/styleguide/a-z-word-list-term-collections/d/downgrade.md
index 0d3481a9..1b068711 100644
--- a/styleguide/a-z-word-list-term-collections/d/downgrade.md
+++ b/styleguide/a-z-word-list-term-collections/d/downgrade.md
@@ -1,5 +1,6 @@
---
title: downgrade - Microsoft Style Guide
+description: In Micrsoft documents, use 'downgrade' only if necessary to express certain concepts, and only in content for an audience that will understand the word in those contexts.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/download.md b/styleguide/a-z-word-list-term-collections/d/download.md
index ad505f10..4c042a4f 100644
--- a/styleguide/a-z-word-list-term-collections/d/download.md
+++ b/styleguide/a-z-word-list-term-collections/d/download.md
@@ -1,5 +1,6 @@
---
title: download - Microsoft Style Guide
+description: Describes guidelines to use 'download' in Microsoft documents, and provides alternate examples. See also 'install.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From e3c2987b1a56141bdc7998fc50a72dbf0508339b Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 10:23:46 -0700
Subject: [PATCH 196/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/d/deselect.md | 2 +-
styleguide/a-z-word-list-term-collections/d/desktop.md | 2 +-
.../d/destination-drive-destination-file.md | 2 +-
styleguide/a-z-word-list-term-collections/d/destination.md | 2 +-
.../d/dialog-box-dialog-dialogue.md | 2 +-
styleguide/a-z-word-list-term-collections/d/different.md | 2 +-
styleguide/a-z-word-list-term-collections/d/dimmed.md | 2 +-
styleguide/a-z-word-list-term-collections/d/directory.md | 2 +-
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 2 +-
.../a-z-word-list-term-collections/d/disjoint-selection.md | 2 +-
.../d/display-adapter-display-driver.md | 2 +-
styleguide/a-z-word-list-term-collections/d/display.md | 2 +-
styleguide/a-z-word-list-term-collections/d/dns.md | 2 +-
styleguide/a-z-word-list-term-collections/d/document.md | 2 +-
styleguide/a-z-word-list-term-collections/d/domain.md | 2 +-
styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md | 2 +-
styleguide/a-z-word-list-term-collections/d/double-buffering.md | 2 +-
styleguide/a-z-word-list-term-collections/d/downgrade.md | 2 +-
styleguide/a-z-word-list-term-collections/d/download.md | 2 +-
19 files changed, 19 insertions(+), 19 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/deselect.md b/styleguide/a-z-word-list-term-collections/d/deselect.md
index 9e17b7c3..8d3ea720 100644
--- a/styleguide/a-z-word-list-term-collections/d/deselect.md
+++ b/styleguide/a-z-word-list-term-collections/d/deselect.md
@@ -1,6 +1,6 @@
---
title: deselect - Microsoft Style Guide
-description: Describes guidelines to use 'deselect' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'deselect' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/desktop.md b/styleguide/a-z-word-list-term-collections/d/desktop.md
index c23baf55..d99b2962 100644
--- a/styleguide/a-z-word-list-term-collections/d/desktop.md
+++ b/styleguide/a-z-word-list-term-collections/d/desktop.md
@@ -1,6 +1,6 @@
---
title: desktop - Microsoft Style Guide
-description: Describes guidelines to use 'desktop' in Microsoft documents, and provides correct and alternate examples.
+description: Describes guidelines to use 'desktop' in Microsoft documents and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md b/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
index 7b1e1a14..98740519 100644
--- a/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
+++ b/styleguide/a-z-word-list-term-collections/d/destination-drive-destination-file.md
@@ -1,6 +1,6 @@
---
title: destination drive, destination file - Microsoft Style Guide
-description: Defines guidelines for using 'destination drive' or 'destination file' in Microsoft documents, and provides alternate examples.
+description: Defines guidelines for using 'destination drive' or 'destination file' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/destination.md b/styleguide/a-z-word-list-term-collections/d/destination.md
index 83ace4fc..35df20d3 100644
--- a/styleguide/a-z-word-list-term-collections/d/destination.md
+++ b/styleguide/a-z-word-list-term-collections/d/destination.md
@@ -1,6 +1,6 @@
---
title: destination - Microsoft Style Guide
-description: Describes guidelines to use 'destination' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'destination' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md b/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
index f6b9e9ca..9831f7b7 100644
--- a/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
+++ b/styleguide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md
@@ -1,6 +1,6 @@
---
title: dialog box, dialog, dialogue - Microsoft Style Guide
-description: Describes guidelines to use 'dialog' in Microsoft documents, and provides correct and alternate examples.
+description: Describes guidelines to use 'dialog' in Microsoft documents and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 03/31/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/different.md b/styleguide/a-z-word-list-term-collections/d/different.md
index 3db694b3..0248cd51 100644
--- a/styleguide/a-z-word-list-term-collections/d/different.md
+++ b/styleguide/a-z-word-list-term-collections/d/different.md
@@ -1,6 +1,6 @@
---
title: different - Microsoft Style Guide
-description: Describes guidelines to use the word 'different' in Microsoft documents, and provides correct and alternate examples.
+description: Describes guidelines to use the word 'different' in Microsoft documents and provides correct and alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dimmed.md b/styleguide/a-z-word-list-term-collections/d/dimmed.md
index cf0ee17f..654abe43 100644
--- a/styleguide/a-z-word-list-term-collections/d/dimmed.md
+++ b/styleguide/a-z-word-list-term-collections/d/dimmed.md
@@ -1,6 +1,6 @@
---
title: dimmed - Microsoft Style Guide
-description: Describes guidelines to use the word 'dimmed' in Microsoft documents, and provides correct examples.
+description: Describes guidelines to use the word 'dimmed' in Microsoft documents and provides correct examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/directory.md b/styleguide/a-z-word-list-term-collections/d/directory.md
index 06c6daec..18a383e9 100644
--- a/styleguide/a-z-word-list-term-collections/d/directory.md
+++ b/styleguide/a-z-word-list-term-collections/d/directory.md
@@ -1,6 +1,6 @@
---
title: directory - Microsoft Style Guide
-description: Describes guidelines to use the word 'directory' in Microsoft documents, including instances where this word is appropriate or allowed.
+description: Describes guidelines to use the word 'directory' in Microsoft documents including instances where this word is appropriate or allowed.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index b77f7488..7dc75bff 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -1,6 +1,6 @@
---
title: disable, disabled - Microsoft Style Guide
-description: Describes guidelines to use 'disable' or 'disabled' in Microsoft documents, including instances where this word is appropriate or allowed.
+description: Describes guidelines to use 'disable' or 'disabled' in Microsoft documents, including instances where this word is appropriate or allowed.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md b/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
index c4723836..fc17b31c 100644
--- a/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
+++ b/styleguide/a-z-word-list-term-collections/d/disjoint-selection.md
@@ -1,6 +1,6 @@
---
title: disjoint selection - Microsoft Style Guide
-description: Describes guidelines to use 'disjoint selection' in Microsoft documents, and provides alternatives.
+description: Describes guidelines to use 'disjoint selection' in Microsoft documents and provides alternatives.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md b/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
index a22de8fa..28227086 100644
--- a/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
+++ b/styleguide/a-z-word-list-term-collections/d/display-adapter-display-driver.md
@@ -1,6 +1,6 @@
---
title: display adapter, display driver - Microsoft Style Guide
-description: Describes guidelines to use 'display adapter' or 'display driver' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'display adapter' or 'display driver' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/display.md b/styleguide/a-z-word-list-term-collections/d/display.md
index d74b5597..ba201706 100644
--- a/styleguide/a-z-word-list-term-collections/d/display.md
+++ b/styleguide/a-z-word-list-term-collections/d/display.md
@@ -1,6 +1,6 @@
---
title: display - Microsoft Style Guide
-description: To see guidelines to use 'display' in Microsoft documents, see the Computer and device term collection.
+description: To see guidelines to use 'display' in Microsoft documents see the Computer and device term collection.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/d/dns.md b/styleguide/a-z-word-list-term-collections/d/dns.md
index bd22ab91..bc644f04 100644
--- a/styleguide/a-z-word-list-term-collections/d/dns.md
+++ b/styleguide/a-z-word-list-term-collections/d/dns.md
@@ -1,6 +1,6 @@
---
title: DNS - Microsoft Style Guide
-description: Describes guidelines to use 'DNS' in Microsoft documents, and provides alternate examples. Includes capitalization guidelines for compound phrases that include 'DNS.'
+description: Describes guidelines to use 'DNS' in Microsoft documents and provides alternate examples. Includes compound-phrase capitalization guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/document.md b/styleguide/a-z-word-list-term-collections/d/document.md
index 2259be88..e120ef8f 100644
--- a/styleguide/a-z-word-list-term-collections/d/document.md
+++ b/styleguide/a-z-word-list-term-collections/d/document.md
@@ -1,6 +1,6 @@
---
title: document - Microsoft Style Guide
-description: Describes guidelines to use 'document' in Microsoft documents, and provides alternate correct examples.
+description: Describes guidelines to use 'document' in Microsoft documents and provides alternate correct examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/domain.md b/styleguide/a-z-word-list-term-collections/d/domain.md
index e3274b5b..a52ce82c 100644
--- a/styleguide/a-z-word-list-term-collections/d/domain.md
+++ b/styleguide/a-z-word-list-term-collections/d/domain.md
@@ -1,6 +1,6 @@
---
title: domain - Microsoft Style Guide
-description: Describes guidelines to use 'domain' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'domain' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md b/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
index 0ce300ef..74b53e52 100644
--- a/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
+++ b/styleguide/a-z-word-list-term-collections/d/dotted-rectangle.md
@@ -1,6 +1,6 @@
---
title: dotted rectangle - Microsoft Style Guide
-description: Describes guidelines to use 'dotted rectangle' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'dotted rectangle' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/double-buffering.md b/styleguide/a-z-word-list-term-collections/d/double-buffering.md
index 5b973c55..71194a97 100644
--- a/styleguide/a-z-word-list-term-collections/d/double-buffering.md
+++ b/styleguide/a-z-word-list-term-collections/d/double-buffering.md
@@ -1,6 +1,6 @@
---
title: double buffering - Microsoft Style Guide
-description: Describes guidelines to use 'double buffering' in Microsoft documents, and provides alternate examples.
+description: Describes guidelines to use 'double buffering' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/downgrade.md b/styleguide/a-z-word-list-term-collections/d/downgrade.md
index 1b068711..29a014e5 100644
--- a/styleguide/a-z-word-list-term-collections/d/downgrade.md
+++ b/styleguide/a-z-word-list-term-collections/d/downgrade.md
@@ -1,6 +1,6 @@
---
title: downgrade - Microsoft Style Guide
-description: In Micrsoft documents, use 'downgrade' only if necessary to express certain concepts, and only in content for an audience that will understand the word in those contexts.
+description: Use 'downgrade' only if necessary to express certain concepts, and only in content for an audience that will understand the word in those contexts.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/download.md b/styleguide/a-z-word-list-term-collections/d/download.md
index 4c042a4f..e2b694a9 100644
--- a/styleguide/a-z-word-list-term-collections/d/download.md
+++ b/styleguide/a-z-word-list-term-collections/d/download.md
@@ -1,6 +1,6 @@
---
title: download - Microsoft Style Guide
-description: Describes guidelines to use 'download' in Microsoft documents, and provides alternate examples. See also 'install.'
+description: Describes guidelines to use 'download' in Microsoft documents and provides alternate examples. See also 'install.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 67e288e3207886fb2a20842d53d860b9d04f9699 Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Thu, 2 Jun 2022 12:15:16 -0600
Subject: [PATCH 197/486] Bulk Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/f/first-line.md | 1 +
styleguide/a-z-word-list-term-collections/f/fitness-band.md | 1 +
styleguide/a-z-word-list-term-collections/f/fixed-disk.md | 1 +
styleguide/a-z-word-list-term-collections/f/flick.md | 1 +
styleguide/a-z-word-list-term-collections/f/flush-flush-to.md | 1 +
styleguide/a-z-word-list-term-collections/f/flyout.md | 1 +
.../a-z-word-list-term-collections/f/folder-folder-icon.md | 1 +
styleguide/a-z-word-list-term-collections/f/following.md | 1 +
styleguide/a-z-word-list-term-collections/f/font-font-style.md | 1 +
styleguide/a-z-word-list-term-collections/f/foo-foobar-fubar.md | 1 +
styleguide/a-z-word-list-term-collections/f/footer.md | 1 +
.../a-z-word-list-term-collections/f/foreground-program.md | 1 +
.../f/format-formatted-formatting.md | 1 +
.../f/fourth-generation-language.md | 1 +
styleguide/a-z-word-list-term-collections/f/frameset.md | 1 +
styleguide/a-z-word-list-term-collections/f/freeze-frozen.md | 1 +
styleguide/a-z-word-list-term-collections/f/friendly-name.md | 1 +
styleguide/a-z-word-list-term-collections/f/from-vs-on.md | 1 +
styleguide/a-z-word-list-term-collections/f/front-end.md | 1 +
styleguide/a-z-word-list-term-collections/f/full-screen.md | 1 +
styleguide/a-z-word-list-term-collections/f/function.md | 1 +
styleguide/a-z-word-list-term-collections/g/gallery.md | 1 +
styleguide/a-z-word-list-term-collections/g/game-pad.md | 1 +
.../g/garbage-collection-garbage-collector.md | 1 +
.../g/general-data-protection-regulation-gdpr.md | 1 +
.../g/general-protection-fault-gp-fault.md | 1 +
styleguide/a-z-word-list-term-collections/g/gigabit.md | 1 +
styleguide/a-z-word-list-term-collections/g/gigabyte.md | 1 +
styleguide/a-z-word-list-term-collections/g/gigahertz.md | 1 +
styleguide/a-z-word-list-term-collections/g/given.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/f/first-line.md b/styleguide/a-z-word-list-term-collections/f/first-line.md
index 671cf8d6..01337182 100644
--- a/styleguide/a-z-word-list-term-collections/f/first-line.md
+++ b/styleguide/a-z-word-list-term-collections/f/first-line.md
@@ -1,5 +1,6 @@
---
title: first line, first-line - Microsoft Style Guide
+description: Describes guidelines to use 'first line' or 'first-line' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 7/10/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/fitness-band.md b/styleguide/a-z-word-list-term-collections/f/fitness-band.md
index 1dd574f9..c58993b8 100644
--- a/styleguide/a-z-word-list-term-collections/f/fitness-band.md
+++ b/styleguide/a-z-word-list-term-collections/f/fitness-band.md
@@ -1,5 +1,6 @@
---
title: fitness band - Microsoft Style Guide
+description: Provides a link to a collection of computer and device terms along with their appropriate usage including 'fitness band'.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/f/fixed-disk.md b/styleguide/a-z-word-list-term-collections/f/fixed-disk.md
index 1b52a6e8..e74386d0 100644
--- a/styleguide/a-z-word-list-term-collections/f/fixed-disk.md
+++ b/styleguide/a-z-word-list-term-collections/f/fixed-disk.md
@@ -1,5 +1,6 @@
---
title: fixed disk - Microsoft Style Guide
+description: Provides a link to a collection of computer and device terms along with their appropriate usage including 'fixed disk'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/flick.md b/styleguide/a-z-word-list-term-collections/f/flick.md
index ea643f41..73a462da 100644
--- a/styleguide/a-z-word-list-term-collections/f/flick.md
+++ b/styleguide/a-z-word-list-term-collections/f/flick.md
@@ -1,5 +1,6 @@
---
title: flick - Microsoft Style Guide
+description: Provides a link to a collection of computer and device terms along with their appropriate usage including 'flick'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/flush-flush-to.md b/styleguide/a-z-word-list-term-collections/f/flush-flush-to.md
index b08ec174..a05c8f2c 100644
--- a/styleguide/a-z-word-list-term-collections/f/flush-flush-to.md
+++ b/styleguide/a-z-word-list-term-collections/f/flush-flush-to.md
@@ -1,5 +1,6 @@
---
title: flush, flush to - Microsoft Style Guide
+description: Describes guidelines to use 'flush' or 'flush to' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/flyout.md b/styleguide/a-z-word-list-term-collections/f/flyout.md
index f48bcf5c..52a1cbe9 100644
--- a/styleguide/a-z-word-list-term-collections/f/flyout.md
+++ b/styleguide/a-z-word-list-term-collections/f/flyout.md
@@ -1,5 +1,6 @@
---
title: flyout - Microsoft Style Guide
+description: Describes guidelines to use 'flyout' in Microsoft documents, and provides alternate examples. Don’t use in content for a general audience.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/folder-folder-icon.md b/styleguide/a-z-word-list-term-collections/f/folder-folder-icon.md
index c2e92670..61c44281 100644
--- a/styleguide/a-z-word-list-term-collections/f/folder-folder-icon.md
+++ b/styleguide/a-z-word-list-term-collections/f/folder-folder-icon.md
@@ -1,5 +1,6 @@
---
title: folder, folder icon - Microsoft Style Guide
+description: Describes guidelines to use 'folder' or 'folder icon' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/following.md b/styleguide/a-z-word-list-term-collections/f/following.md
index fc86524a..9037470a 100644
--- a/styleguide/a-z-word-list-term-collections/f/following.md
+++ b/styleguide/a-z-word-list-term-collections/f/following.md
@@ -1,5 +1,6 @@
---
title: following - Microsoft Style Guide
+description: Describes guidelines to use 'following' in Microsoft documents, and provides an example with additional reference links.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/font-font-style.md b/styleguide/a-z-word-list-term-collections/f/font-font-style.md
index e748c753..ed8760fc 100644
--- a/styleguide/a-z-word-list-term-collections/f/font-font-style.md
+++ b/styleguide/a-z-word-list-term-collections/f/font-font-style.md
@@ -1,5 +1,6 @@
---
title: font, font style - Microsoft Style Guide
+description: Describes guidelines to use 'font' or 'font style in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/foo-foobar-fubar.md b/styleguide/a-z-word-list-term-collections/f/foo-foobar-fubar.md
index c8295f10..5f2c8924 100644
--- a/styleguide/a-z-word-list-term-collections/f/foo-foobar-fubar.md
+++ b/styleguide/a-z-word-list-term-collections/f/foo-foobar-fubar.md
@@ -1,5 +1,6 @@
---
title: foo, foobar, fubar - Microsoft Style Guide
+description: Describes guidelines to use 'foo', 'foobar', or 'fubar' in Microsoft documents. Do not use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/footer.md b/styleguide/a-z-word-list-term-collections/f/footer.md
index a448c40f..843d4adb 100644
--- a/styleguide/a-z-word-list-term-collections/f/footer.md
+++ b/styleguide/a-z-word-list-term-collections/f/footer.md
@@ -1,5 +1,6 @@
---
title: footer - Microsoft Style Guide
+description: Describes guidelines to use 'footer' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/foreground-program.md b/styleguide/a-z-word-list-term-collections/f/foreground-program.md
index 32f556e7..e768537f 100644
--- a/styleguide/a-z-word-list-term-collections/f/foreground-program.md
+++ b/styleguide/a-z-word-list-term-collections/f/foreground-program.md
@@ -1,5 +1,6 @@
---
title: foreground program - Microsoft Style Guide
+description: Describes guidelines to use 'foreground program' in Microsoft documents. In content for a technical audience.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/format-formatted-formatting.md b/styleguide/a-z-word-list-term-collections/f/format-formatted-formatting.md
index 96129d2e..8d81f0f1 100644
--- a/styleguide/a-z-word-list-term-collections/f/format-formatted-formatting.md
+++ b/styleguide/a-z-word-list-term-collections/f/format-formatted-formatting.md
@@ -1,5 +1,6 @@
---
title: format, formatted, formatting - Microsoft Style Guide
+description: Defines guidelines for using 'format', 'formatted', or 'formatting' in Microsoft documents, and provides an additional resource link.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/fourth-generation-language.md b/styleguide/a-z-word-list-term-collections/f/fourth-generation-language.md
index 738363bd..8d4c46e7 100644
--- a/styleguide/a-z-word-list-term-collections/f/fourth-generation-language.md
+++ b/styleguide/a-z-word-list-term-collections/f/fourth-generation-language.md
@@ -1,5 +1,6 @@
---
title: fourth-generation language - Microsoft Style Guide
+description: Describes guidelines to use 'fourth-generation language' in Microsoft documents. Spell out on the first mention.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/frameset.md b/styleguide/a-z-word-list-term-collections/f/frameset.md
index 8d179945..7e12e400 100644
--- a/styleguide/a-z-word-list-term-collections/f/frameset.md
+++ b/styleguide/a-z-word-list-term-collections/f/frameset.md
@@ -1,5 +1,6 @@
---
title: frameset - Microsoft Style Guide
+description: Describes guidelines to use 'frameset' in Microsoft documents, and provides alternate examples. Use only in content for developers.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/freeze-frozen.md b/styleguide/a-z-word-list-term-collections/f/freeze-frozen.md
index 5a8f4321..aa0b4d18 100644
--- a/styleguide/a-z-word-list-term-collections/f/freeze-frozen.md
+++ b/styleguide/a-z-word-list-term-collections/f/freeze-frozen.md
@@ -1,5 +1,6 @@
---
title: freeze, frozen - Microsoft Style Guide
+description: Defines guidelines for using 'freeze' or 'frozen' in Microsoft documents, and provides an additional resource link.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/friendly-name.md b/styleguide/a-z-word-list-term-collections/f/friendly-name.md
index bc40c318..0b3f513f 100644
--- a/styleguide/a-z-word-list-term-collections/f/friendly-name.md
+++ b/styleguide/a-z-word-list-term-collections/f/friendly-name.md
@@ -1,5 +1,6 @@
---
title: friendly name - Microsoft Style Guide
+description: Defines guidelines for using 'friendly name' in Microsoft documents, and provides an alternative examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/from-vs-on.md b/styleguide/a-z-word-list-term-collections/f/from-vs-on.md
index aab1cc97..f80a7d5c 100644
--- a/styleguide/a-z-word-list-term-collections/f/from-vs-on.md
+++ b/styleguide/a-z-word-list-term-collections/f/from-vs-on.md
@@ -1,5 +1,6 @@
---
title: from vs. on - Microsoft Style Guide
+description: Defines guidelines for using 'from' versus 'on' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/front-end.md b/styleguide/a-z-word-list-term-collections/f/front-end.md
index 06906b11..4979febd 100644
--- a/styleguide/a-z-word-list-term-collections/f/front-end.md
+++ b/styleguide/a-z-word-list-term-collections/f/front-end.md
@@ -1,5 +1,6 @@
---
title: front end, front-end - Microsoft Style Guide
+description: Defines guidelines for using 'front end' or 'front-end' in Microsoft documents. Two words as a noun. Hyphenate as an adjective.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/full-screen.md b/styleguide/a-z-word-list-term-collections/f/full-screen.md
index c5816fe3..4ad19826 100644
--- a/styleguide/a-z-word-list-term-collections/f/full-screen.md
+++ b/styleguide/a-z-word-list-term-collections/f/full-screen.md
@@ -1,5 +1,6 @@
---
title: full screen, full-screen - Microsoft Style Guide
+description: Defines guidelines for using 'full screen' or 'full-screen' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 03/16/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/function.md b/styleguide/a-z-word-list-term-collections/f/function.md
index 5a5dad61..9e7602bb 100644
--- a/styleguide/a-z-word-list-term-collections/f/function.md
+++ b/styleguide/a-z-word-list-term-collections/f/function.md
@@ -1,5 +1,6 @@
---
title: function - Microsoft Style Guide
+description: Defines guidelines for using 'function' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gallery.md b/styleguide/a-z-word-list-term-collections/g/gallery.md
index 445b4573..8fad9537 100644
--- a/styleguide/a-z-word-list-term-collections/g/gallery.md
+++ b/styleguide/a-z-word-list-term-collections/g/gallery.md
@@ -1,5 +1,6 @@
---
title: gallery - Microsoft Style Guide
+description: Defines guidelines for using 'gallery' in Microsoft documents, and provides an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/game-pad.md b/styleguide/a-z-word-list-term-collections/g/game-pad.md
index 0fef0111..a9de010b 100644
--- a/styleguide/a-z-word-list-term-collections/g/game-pad.md
+++ b/styleguide/a-z-word-list-term-collections/g/game-pad.md
@@ -1,5 +1,6 @@
---
title: game pad - Microsoft Style Guide
+description: Describes guidelines for using 'game pad' in Microsoft documents. Two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/garbage-collection-garbage-collector.md b/styleguide/a-z-word-list-term-collections/g/garbage-collection-garbage-collector.md
index f79fb919..de2e2488 100644
--- a/styleguide/a-z-word-list-term-collections/g/garbage-collection-garbage-collector.md
+++ b/styleguide/a-z-word-list-term-collections/g/garbage-collection-garbage-collector.md
@@ -1,5 +1,6 @@
---
title: garbage collection, garbage collector - Microsoft Style Guide
+description: Defines guidelines for using 'garbage collection' or 'garbage collector' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/general-data-protection-regulation-gdpr.md b/styleguide/a-z-word-list-term-collections/g/general-data-protection-regulation-gdpr.md
index f7e39a51..c8c7e035 100644
--- a/styleguide/a-z-word-list-term-collections/g/general-data-protection-regulation-gdpr.md
+++ b/styleguide/a-z-word-list-term-collections/g/general-data-protection-regulation-gdpr.md
@@ -1,5 +1,6 @@
---
title: General Data Protection Regulation (GDPR) - Microsoft Style Guide
+description: Describes guidelines for using 'General Data Protection Regulation (GDPR)' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 02/16/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/general-protection-fault-gp-fault.md b/styleguide/a-z-word-list-term-collections/g/general-protection-fault-gp-fault.md
index e1bc23f9..1f62b229 100644
--- a/styleguide/a-z-word-list-term-collections/g/general-protection-fault-gp-fault.md
+++ b/styleguide/a-z-word-list-term-collections/g/general-protection-fault-gp-fault.md
@@ -1,5 +1,6 @@
---
title: general protection fault, GP fault - Microsoft Style Guide
+description: Defines guidelines for using 'general protection fault' or 'GP fault' in Microsoft documents. Spell out on the first mention.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gigabit.md b/styleguide/a-z-word-list-term-collections/g/gigabit.md
index 83b3735a..41bd57e2 100644
--- a/styleguide/a-z-word-list-term-collections/g/gigabit.md
+++ b/styleguide/a-z-word-list-term-collections/g/gigabit.md
@@ -1,5 +1,6 @@
---
title: gigabit, Gbit - Microsoft Style Guide
+description: Provides a reference link to 'bits and bytes' terms which includes 'gigabit' or 'Gbit'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gigabyte.md b/styleguide/a-z-word-list-term-collections/g/gigabyte.md
index faa4f27c..a74e750f 100644
--- a/styleguide/a-z-word-list-term-collections/g/gigabyte.md
+++ b/styleguide/a-z-word-list-term-collections/g/gigabyte.md
@@ -1,5 +1,6 @@
---
title: gigabyte, GB, G, G byte, Gbyte - Microsoft Style Guide
+description: Provides a reference link to 'bits and bytes' terms which includes 'gigabyte', 'GB', 'G', 'G byte', or 'Gbyte'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gigahertz.md b/styleguide/a-z-word-list-term-collections/g/gigahertz.md
index 26fa7f18..98519401 100644
--- a/styleguide/a-z-word-list-term-collections/g/gigahertz.md
+++ b/styleguide/a-z-word-list-term-collections/g/gigahertz.md
@@ -1,5 +1,6 @@
---
title: gigahertz, GHz - Microsoft Style Guide
+description: Provides a reference link to 'units of measure' terms which includes 'gigahertz' or 'GHz'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/given.md b/styleguide/a-z-word-list-term-collections/g/given.md
index d524bb94..46efb5c9 100644
--- a/styleguide/a-z-word-list-term-collections/g/given.md
+++ b/styleguide/a-z-word-list-term-collections/g/given.md
@@ -1,5 +1,6 @@
---
title: given - Microsoft Style Guide
+description: Describes guidelines to use 'given' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 04d876e683c08167a65d960e31d5592a849be39a Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 12:05:23 -0700
Subject: [PATCH 198/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/d/drag-and-drop.md | 1 +
.../d/drill-down-drill-up-drill-through.md | 1 +
2 files changed, 2 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/drag-and-drop.md b/styleguide/a-z-word-list-term-collections/d/drag-and-drop.md
index 080acf28..3401c2fe 100644
--- a/styleguide/a-z-word-list-term-collections/d/drag-and-drop.md
+++ b/styleguide/a-z-word-list-term-collections/d/drag-and-drop.md
@@ -1,5 +1,6 @@
---
title: drag, drag and drop - Microsoft Style Guide
+description: Describes guidelines to use 'drag' or 'drag and drop' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md b/styleguide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md
index 06b05070..251328cc 100644
--- a/styleguide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md
+++ b/styleguide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md
@@ -1,5 +1,6 @@
---
title: drill down, drill up, drill through - Microsoft Style Guide
+description: Describes guidelines to use 'drill down', 'drill up', or 'drill through' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 11/26/2018
From f92f29b95a5d4ea7f83c147b46d5581eab3eae6f Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 12:54:20 -0700
Subject: [PATCH 199/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/d/drive-name.md | 1 +
styleguide/a-z-word-list-term-collections/d/drive.md | 1 +
styleguide/a-z-word-list-term-collections/d/dropdown.md | 1 +
styleguide/a-z-word-list-term-collections/d/dvd.md | 1 +
.../a-z-word-list-term-collections/d/dynamic-link-library-dll.md | 1 +
.../a-z-word-list-term-collections/d/dynamic-service-capacity.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-book.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-commerce.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-discovery.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-form-form.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-learning.md | 1 +
styleguide/a-z-word-list-term-collections/e/earlier.md | 1 +
styleguide/a-z-word-list-term-collections/e/edutainment.md | 1 +
styleguide/a-z-word-list-term-collections/e/eg.md | 1 +
styleguide/a-z-word-list-term-collections/e/either-or.md | 1 +
.../a-z-word-list-term-collections/e/elastic-service-capacity.md | 1 +
styleguide/a-z-word-list-term-collections/e/email.md | 1 +
styleguide/a-z-word-list-term-collections/e/embed.md | 1 +
styleguide/a-z-word-list-term-collections/e/emoticons-emoji.md | 1 +
styleguide/a-z-word-list-term-collections/e/enable-enables.md | 1 +
.../e/end-user-license-agreement-eula.md | 1 +
styleguide/a-z-word-list-term-collections/e/end.md | 1 +
styleguide/a-z-word-list-term-collections/e/endline.md | 1 +
styleguide/a-z-word-list-term-collections/e/endpoint.md | 1 +
.../a-z-word-list-term-collections/e/ensure-insure-assure.md | 1 +
styleguide/a-z-word-list-term-collections/e/enter.md | 1 +
styleguide/a-z-word-list-term-collections/e/enterprise.md | 1 +
styleguide/a-z-word-list-term-collections/e/entry-field.md | 1 +
.../a-z-word-list-term-collections/e/environment-variable.md | 1 +
styleguide/a-z-word-list-term-collections/e/erase.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/drive-name.md b/styleguide/a-z-word-list-term-collections/d/drive-name.md
index e6edab08..5748eeba 100644
--- a/styleguide/a-z-word-list-term-collections/d/drive-name.md
+++ b/styleguide/a-z-word-list-term-collections/d/drive-name.md
@@ -1,5 +1,6 @@
---
title: drive name - Microsoft Style Guide
+description: Describes guidelines to use 'drive name' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/drive.md b/styleguide/a-z-word-list-term-collections/d/drive.md
index 2d51727d..9cec65cd 100644
--- a/styleguide/a-z-word-list-term-collections/d/drive.md
+++ b/styleguide/a-z-word-list-term-collections/d/drive.md
@@ -1,5 +1,6 @@
---
title: drive - Microsoft Style Guide
+description: To use 'drive' in Microsoft documents and see alternate examples, see 'Computer and device term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dropdown.md b/styleguide/a-z-word-list-term-collections/d/dropdown.md
index 7dc132fb..4f6e49b9 100644
--- a/styleguide/a-z-word-list-term-collections/d/dropdown.md
+++ b/styleguide/a-z-word-list-term-collections/d/dropdown.md
@@ -1,5 +1,6 @@
---
title: dropdown - Microsoft Style Guide
+description: Describes guidelines to use 'dropdown' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 03/26/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/dvd.md b/styleguide/a-z-word-list-term-collections/d/dvd.md
index ea41f633..7c7e928a 100644
--- a/styleguide/a-z-word-list-term-collections/d/dvd.md
+++ b/styleguide/a-z-word-list-term-collections/d/dvd.md
@@ -1,5 +1,6 @@
---
title: DVD - Microsoft Style Guide
+description: Describes guidelines to use 'DVD' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dynamic-link-library-dll.md b/styleguide/a-z-word-list-term-collections/d/dynamic-link-library-dll.md
index edf36e05..74a7a54f 100644
--- a/styleguide/a-z-word-list-term-collections/d/dynamic-link-library-dll.md
+++ b/styleguide/a-z-word-list-term-collections/d/dynamic-link-library-dll.md
@@ -1,5 +1,6 @@
---
title: dynamic-link library (DLL) - Microsoft Style Guide
+description: Describes guidelines to use 'dynamic-link library (DLL)' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dynamic-service-capacity.md b/styleguide/a-z-word-list-term-collections/d/dynamic-service-capacity.md
index 51f2d220..04d3eace 100644
--- a/styleguide/a-z-word-list-term-collections/d/dynamic-service-capacity.md
+++ b/styleguide/a-z-word-list-term-collections/d/dynamic-service-capacity.md
@@ -1,5 +1,6 @@
---
title: dynamic service capacity - Microsoft Style Guide
+description: To use 'dynamic service capacity' in Microsoft documents, see 'Cloud-computing term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-book.md b/styleguide/a-z-word-list-term-collections/e/e-book.md
index bd37edee..1338a800 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-book.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-book.md
@@ -1,5 +1,6 @@
---
title: e-book - Microsoft Style Guide
+description: Describes guidelines to use 'e-book' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-commerce.md b/styleguide/a-z-word-list-term-collections/e/e-commerce.md
index 5d586a8b..bdd977d4 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-commerce.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-commerce.md
@@ -1,5 +1,6 @@
---
title: e-commerce - Microsoft Style Guide
+description: Describes guidelines to use 'e-commerce' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-discovery.md b/styleguide/a-z-word-list-term-collections/e/e-discovery.md
index 28cec5bd..8c8d9f84 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-discovery.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-discovery.md
@@ -1,5 +1,6 @@
---
title: e-discovery - Microsoft Style Guide
+description: Describes guidelines to use 'e-discovery' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-form-form.md b/styleguide/a-z-word-list-term-collections/e/e-form-form.md
index 0b610f3e..432013e5 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-form-form.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-form-form.md
@@ -1,5 +1,6 @@
---
title: e-form, form - Microsoft Style Guide
+description: Describes guidelines to use 'e-form' and 'form' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-learning.md b/styleguide/a-z-word-list-term-collections/e/e-learning.md
index eb415fac..5f82e66d 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-learning.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-learning.md
@@ -1,5 +1,6 @@
---
title: e-learning - Microsoft Style Guide
+description: Describes guidelines to use 'e-learning' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/earlier.md b/styleguide/a-z-word-list-term-collections/e/earlier.md
index a16014bf..6823543f 100644
--- a/styleguide/a-z-word-list-term-collections/e/earlier.md
+++ b/styleguide/a-z-word-list-term-collections/e/earlier.md
@@ -1,5 +1,6 @@
---
title: earlier - Microsoft Style Guide
+description: Describes guidelines to use 'earlier' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/edutainment.md b/styleguide/a-z-word-list-term-collections/e/edutainment.md
index 29848357..5613babf 100644
--- a/styleguide/a-z-word-list-term-collections/e/edutainment.md
+++ b/styleguide/a-z-word-list-term-collections/e/edutainment.md
@@ -1,5 +1,6 @@
---
title: edutainment - Microsoft Style Guide
+description: Describes guidelines to use 'edutainment' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/eg.md b/styleguide/a-z-word-list-term-collections/e/eg.md
index 8d66a86e..4bdf00c8 100644
--- a/styleguide/a-z-word-list-term-collections/e/eg.md
+++ b/styleguide/a-z-word-list-term-collections/e/eg.md
@@ -1,5 +1,6 @@
---
title: e.g. - Microsoft Style Guide
+description: Describes guidelines for alternatives to 'e.g.' in Microsoft documents and provides correct examples.
author: pallep
ms.author: pallep
ms.date: 11/8/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/either-or.md b/styleguide/a-z-word-list-term-collections/e/either-or.md
index a85491d3..ff484179 100644
--- a/styleguide/a-z-word-list-term-collections/e/either-or.md
+++ b/styleguide/a-z-word-list-term-collections/e/either-or.md
@@ -1,5 +1,6 @@
---
title: either/or - Microsoft Style Guide
+description: Describes guidelines to use 'either/or' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/elastic-service-capacity.md b/styleguide/a-z-word-list-term-collections/e/elastic-service-capacity.md
index b0832760..a95d047a 100644
--- a/styleguide/a-z-word-list-term-collections/e/elastic-service-capacity.md
+++ b/styleguide/a-z-word-list-term-collections/e/elastic-service-capacity.md
@@ -1,5 +1,6 @@
---
title: elastic service capacity - Microsoft Style Guide
+description: For more information on using 'elastic service capacity' in Microsoft documents, see 'Cloud-computing term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/email.md b/styleguide/a-z-word-list-term-collections/e/email.md
index 6de7a533..4b788f6b 100644
--- a/styleguide/a-z-word-list-term-collections/e/email.md
+++ b/styleguide/a-z-word-list-term-collections/e/email.md
@@ -1,5 +1,6 @@
---
title: email - Microsoft Style Guide
+description: Describes guidelines to use 'email' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/embed.md b/styleguide/a-z-word-list-term-collections/e/embed.md
index ba7885f2..1548eab9 100644
--- a/styleguide/a-z-word-list-term-collections/e/embed.md
+++ b/styleguide/a-z-word-list-term-collections/e/embed.md
@@ -1,5 +1,6 @@
---
title: embed - Microsoft Style Guide
+description: Describes guidelines to use 'embed' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/emoticons-emoji.md b/styleguide/a-z-word-list-term-collections/e/emoticons-emoji.md
index dc6c7adf..fe9f8573 100644
--- a/styleguide/a-z-word-list-term-collections/e/emoticons-emoji.md
+++ b/styleguide/a-z-word-list-term-collections/e/emoticons-emoji.md
@@ -1,5 +1,6 @@
---
title: emoticons, emoji - Microsoft Style Guide
+description: Describes guidelines to use emoticons and emojis in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/enable-enables.md b/styleguide/a-z-word-list-term-collections/e/enable-enables.md
index 17237e0f..ed8aa6d7 100644
--- a/styleguide/a-z-word-list-term-collections/e/enable-enables.md
+++ b/styleguide/a-z-word-list-term-collections/e/enable-enables.md
@@ -1,5 +1,6 @@
---
title: enable, enables - Microsoft Style Guide
+description: Describes guidelines to use 'enable' or 'enables' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/end-user-license-agreement-eula.md b/styleguide/a-z-word-list-term-collections/e/end-user-license-agreement-eula.md
index 47e2df99..c0aa9d87 100644
--- a/styleguide/a-z-word-list-term-collections/e/end-user-license-agreement-eula.md
+++ b/styleguide/a-z-word-list-term-collections/e/end-user-license-agreement-eula.md
@@ -1,5 +1,6 @@
---
title: End-User License Agreement (EULA) - Microsoft Style Guide
+description: Describes guidelines to use 'End-User License Agreement (EULA)' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/end.md b/styleguide/a-z-word-list-term-collections/e/end.md
index 265415fe..46908535 100644
--- a/styleguide/a-z-word-list-term-collections/e/end.md
+++ b/styleguide/a-z-word-list-term-collections/e/end.md
@@ -1,5 +1,6 @@
---
title: end - Microsoft Style Guide
+description: Describes guidelines to use 'end' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/endline.md b/styleguide/a-z-word-list-term-collections/e/endline.md
index bf9251ac..7eec6222 100644
--- a/styleguide/a-z-word-list-term-collections/e/endline.md
+++ b/styleguide/a-z-word-list-term-collections/e/endline.md
@@ -1,5 +1,6 @@
---
title: endline - Microsoft Style Guide
+description: Describes guidelines to use 'endline' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/endpoint.md b/styleguide/a-z-word-list-term-collections/e/endpoint.md
index 2180ca22..dc5af729 100644
--- a/styleguide/a-z-word-list-term-collections/e/endpoint.md
+++ b/styleguide/a-z-word-list-term-collections/e/endpoint.md
@@ -1,5 +1,6 @@
---
title: endpoint - Microsoft Style Guide
+description: Describes guidelines to use 'endpoint' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/ensure-insure-assure.md b/styleguide/a-z-word-list-term-collections/e/ensure-insure-assure.md
index fc7465a3..0db3d5b5 100644
--- a/styleguide/a-z-word-list-term-collections/e/ensure-insure-assure.md
+++ b/styleguide/a-z-word-list-term-collections/e/ensure-insure-assure.md
@@ -1,5 +1,6 @@
---
title: ensure, insure, assure - Microsoft Style Guide
+description: Describes guidelines to use 'ensure', 'insure', and 'assure' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/enter.md b/styleguide/a-z-word-list-term-collections/e/enter.md
index 0df9ac35..900eca0e 100644
--- a/styleguide/a-z-word-list-term-collections/e/enter.md
+++ b/styleguide/a-z-word-list-term-collections/e/enter.md
@@ -1,5 +1,6 @@
---
title: enter - Microsoft Style Guide
+description: See 'Describing interactions with UI' for guidelines to use 'enter' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/enterprise.md b/styleguide/a-z-word-list-term-collections/e/enterprise.md
index fb8b5d9d..f93ca7e5 100644
--- a/styleguide/a-z-word-list-term-collections/e/enterprise.md
+++ b/styleguide/a-z-word-list-term-collections/e/enterprise.md
@@ -1,5 +1,6 @@
---
title: enterprise - Microsoft Style Guide
+description: Describes guidelines to use 'enterprise' in Microsoft documents. Don't use in content for a general audience.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/entry-field.md b/styleguide/a-z-word-list-term-collections/e/entry-field.md
index 952a4500..f26cf216 100644
--- a/styleguide/a-z-word-list-term-collections/e/entry-field.md
+++ b/styleguide/a-z-word-list-term-collections/e/entry-field.md
@@ -1,5 +1,6 @@
---
title: entry field - Microsoft Style Guide
+description: Describes guidelines to use 'entry field' in Microsoft documents including permissible uses.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/environment-variable.md b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
index 952c2859..7501c58f 100644
--- a/styleguide/a-z-word-list-term-collections/e/environment-variable.md
+++ b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
@@ -1,5 +1,6 @@
---
title: environment variable - Microsoft Style Guide
+description: In Microsoft documents, 'environment variable' contains configuration information that can be referenced by anything in the environment.
author: pallep
ms.author: pallep
ms.date: 01/15/2021
diff --git a/styleguide/a-z-word-list-term-collections/e/erase.md b/styleguide/a-z-word-list-term-collections/e/erase.md
index 3a799d56..253cc840 100644
--- a/styleguide/a-z-word-list-term-collections/e/erase.md
+++ b/styleguide/a-z-word-list-term-collections/e/erase.md
@@ -1,5 +1,6 @@
---
title: erase - Microsoft Style Guide
+description: Describes guidelines to use 'erase' in Microsoft documents. See 'delete' for additional information.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From e4f9dbc8e36d841d795a534067300d7d4ea3372e Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 12:57:12 -0700
Subject: [PATCH 200/486] Validation: add missing descriptions
---
.../a-z-word-list-term-collections/e/environment-variable.md | 1 -
styleguide/a-z-word-list-term-collections/e/erase.md | 1 -
2 files changed, 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/e/environment-variable.md b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
index 7501c58f..952c2859 100644
--- a/styleguide/a-z-word-list-term-collections/e/environment-variable.md
+++ b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
@@ -1,6 +1,5 @@
---
title: environment variable - Microsoft Style Guide
-description: In Microsoft documents, 'environment variable' contains configuration information that can be referenced by anything in the environment.
author: pallep
ms.author: pallep
ms.date: 01/15/2021
diff --git a/styleguide/a-z-word-list-term-collections/e/erase.md b/styleguide/a-z-word-list-term-collections/e/erase.md
index 253cc840..3a799d56 100644
--- a/styleguide/a-z-word-list-term-collections/e/erase.md
+++ b/styleguide/a-z-word-list-term-collections/e/erase.md
@@ -1,6 +1,5 @@
---
title: erase - Microsoft Style Guide
-description: Describes guidelines to use 'erase' in Microsoft documents. See 'delete' for additional information.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 4f2e387f46a9a508523881e80551ed2b8b6469a9 Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 13:36:34 -0700
Subject: [PATCH 201/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/e/e-sports.md | 1 +
styleguide/a-z-word-list-term-collections/e/e-words.md | 1 +
.../a-z-word-list-term-collections/e/environment-variable.md | 1 +
styleguide/a-z-word-list-term-collections/e/erase.md | 1 +
styleguide/a-z-word-list-term-collections/e/et-al.md | 1 +
styleguide/a-z-word-list-term-collections/e/etc.md | 1 +
styleguide/a-z-word-list-term-collections/e/euro.md | 1 +
styleguide/a-z-word-list-term-collections/e/executable-exe.md | 1 +
styleguide/a-z-word-list-term-collections/e/execute.md | 1 +
styleguide/a-z-word-list-term-collections/e/exit.md | 1 +
styleguide/a-z-word-list-term-collections/e/expand-collapse.md | 1 +
styleguide/a-z-word-list-term-collections/e/expose.md | 1 +
styleguide/a-z-word-list-term-collections/e/extend.md | 1 +
.../e/extension-file-name-extension.md | 1 +
styleguide/a-z-word-list-term-collections/f/FALSE.md | 1 +
.../f/fail-over-fail-back-failover-failback.md | 1 +
styleguide/a-z-word-list-term-collections/f/fail.md | 1 +
styleguide/a-z-word-list-term-collections/f/family.md | 1 +
styleguide/a-z-word-list-term-collections/f/far-east.md | 1 +
.../a-z-word-list-term-collections/f/far-left-far-right.md | 1 +
styleguide/a-z-word-list-term-collections/f/favorite.md | 1 +
styleguide/a-z-word-list-term-collections/f/fax.md | 1 +
styleguide/a-z-word-list-term-collections/f/field.md | 1 +
styleguide/a-z-word-list-term-collections/f/file-attributes.md | 1 +
styleguide/a-z-word-list-term-collections/f/file-explorer.md | 1 +
.../f/file-name-extension-extension.md | 1 +
styleguide/a-z-word-list-term-collections/f/file-name.md | 1 +
styleguide/a-z-word-list-term-collections/f/file.md | 1 +
styleguide/a-z-word-list-term-collections/f/finalize.md | 1 +
styleguide/a-z-word-list-term-collections/f/find-replace.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/e/e-sports.md b/styleguide/a-z-word-list-term-collections/e/e-sports.md
index 09a393fb..07615aa2 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-sports.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-sports.md
@@ -1,5 +1,6 @@
---
title: e-sports - Microsoft Style Guide
+description: Describes guidelines to use 'e-sports' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 09/10/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/e-words.md b/styleguide/a-z-word-list-term-collections/e/e-words.md
index 07f829f2..3979109e 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-words.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-words.md
@@ -1,5 +1,6 @@
---
title: e-words - Microsoft Style Guide
+description: Describes guidelines to use 'e-words' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/environment-variable.md b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
index 952c2859..69d25871 100644
--- a/styleguide/a-z-word-list-term-collections/e/environment-variable.md
+++ b/styleguide/a-z-word-list-term-collections/e/environment-variable.md
@@ -1,5 +1,6 @@
---
title: environment variable - Microsoft Style Guide
+description: Describes 'environment variable' as used in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/15/2021
diff --git a/styleguide/a-z-word-list-term-collections/e/erase.md b/styleguide/a-z-word-list-term-collections/e/erase.md
index 3a799d56..82da8038 100644
--- a/styleguide/a-z-word-list-term-collections/e/erase.md
+++ b/styleguide/a-z-word-list-term-collections/e/erase.md
@@ -1,5 +1,6 @@
---
title: erase - Microsoft Style Guide
+description: Describes guidelines to use 'erase' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/et-al.md b/styleguide/a-z-word-list-term-collections/e/et-al.md
index 5146f588..81efb650 100644
--- a/styleguide/a-z-word-list-term-collections/e/et-al.md
+++ b/styleguide/a-z-word-list-term-collections/e/et-al.md
@@ -1,5 +1,6 @@
---
title: et al. - Microsoft Style Guide
+description: Describes guidelines to use 'et al.' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/etc.md b/styleguide/a-z-word-list-term-collections/e/etc.md
index c456fecb..cd9c8ff8 100644
--- a/styleguide/a-z-word-list-term-collections/e/etc.md
+++ b/styleguide/a-z-word-list-term-collections/e/etc.md
@@ -1,5 +1,6 @@
---
title: etc. - Microsoft Style Guide
+description: Describes guidelines to use 'etc.' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 06/27/2019
diff --git a/styleguide/a-z-word-list-term-collections/e/euro.md b/styleguide/a-z-word-list-term-collections/e/euro.md
index 2cfe5a2d..a7c6a44c 100644
--- a/styleguide/a-z-word-list-term-collections/e/euro.md
+++ b/styleguide/a-z-word-list-term-collections/e/euro.md
@@ -1,5 +1,6 @@
---
title: euro - Microsoft Style Guide
+description: Describes guidelines to use 'euro' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/executable-exe.md b/styleguide/a-z-word-list-term-collections/e/executable-exe.md
index 9fef105f..a4a8a90b 100644
--- a/styleguide/a-z-word-list-term-collections/e/executable-exe.md
+++ b/styleguide/a-z-word-list-term-collections/e/executable-exe.md
@@ -1,5 +1,6 @@
---
title: executable, .exe - Microsoft Style Guide
+description: Describes guidelines to use 'executable' or '.exe' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/execute.md b/styleguide/a-z-word-list-term-collections/e/execute.md
index 63893770..ef3c9fc7 100644
--- a/styleguide/a-z-word-list-term-collections/e/execute.md
+++ b/styleguide/a-z-word-list-term-collections/e/execute.md
@@ -1,5 +1,6 @@
---
title: execute - Microsoft Style Guide
+description: Describes guidelines to use 'execute' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/exit.md b/styleguide/a-z-word-list-term-collections/e/exit.md
index e06dd7b5..4565258e 100644
--- a/styleguide/a-z-word-list-term-collections/e/exit.md
+++ b/styleguide/a-z-word-list-term-collections/e/exit.md
@@ -1,5 +1,6 @@
---
title: exit - Microsoft Style Guide
+description: To find guidelines to use 'exit' in Microsoft documents, see 'Describing interactions with UI.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/expand-collapse.md b/styleguide/a-z-word-list-term-collections/e/expand-collapse.md
index 4f7ef39f..34e37ed2 100644
--- a/styleguide/a-z-word-list-term-collections/e/expand-collapse.md
+++ b/styleguide/a-z-word-list-term-collections/e/expand-collapse.md
@@ -1,5 +1,6 @@
---
title: expand, collapse - Microsoft Style Guide
+description: Describes guidelines to use 'expand' or 'collapse' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/expose.md b/styleguide/a-z-word-list-term-collections/e/expose.md
index a5c5539a..69afde52 100644
--- a/styleguide/a-z-word-list-term-collections/e/expose.md
+++ b/styleguide/a-z-word-list-term-collections/e/expose.md
@@ -1,5 +1,6 @@
---
title: expose - Microsoft Style Guide
+description: Describes guidelines to use 'expose' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/extend.md b/styleguide/a-z-word-list-term-collections/e/extend.md
index ea7bea7c..fda70a6e 100644
--- a/styleguide/a-z-word-list-term-collections/e/extend.md
+++ b/styleguide/a-z-word-list-term-collections/e/extend.md
@@ -1,5 +1,6 @@
---
title: extend - Microsoft Style Guide
+description: Describes guidelines to use 'extend' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/e/extension-file-name-extension.md b/styleguide/a-z-word-list-term-collections/e/extension-file-name-extension.md
index be1beb72..915fb312 100644
--- a/styleguide/a-z-word-list-term-collections/e/extension-file-name-extension.md
+++ b/styleguide/a-z-word-list-term-collections/e/extension-file-name-extension.md
@@ -1,5 +1,6 @@
---
title: extension, file name extension - Microsoft Style Guide
+description: Describes guidelines to use 'extension' or 'file name extension' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/FALSE.md b/styleguide/a-z-word-list-term-collections/f/FALSE.md
index fa39441f..fb8193ce 100644
--- a/styleguide/a-z-word-list-term-collections/f/FALSE.md
+++ b/styleguide/a-z-word-list-term-collections/f/FALSE.md
@@ -1,5 +1,6 @@
---
title: FALSE - Microsoft Style Guide
+description: Describes guidelines to use 'FALSE' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback.md b/styleguide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback.md
index 92385d42..f7b0e6b1 100644
--- a/styleguide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback.md
+++ b/styleguide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback.md
@@ -1,5 +1,6 @@
---
title: fail over, fail back, failover, failback - Microsoft Style Guide
+description: Describes guidelines to use 'fail over', 'fail back', 'failover', or 'failback' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 04/1/2019
diff --git a/styleguide/a-z-word-list-term-collections/f/fail.md b/styleguide/a-z-word-list-term-collections/f/fail.md
index 6f993178..f1bf9d45 100644
--- a/styleguide/a-z-word-list-term-collections/f/fail.md
+++ b/styleguide/a-z-word-list-term-collections/f/fail.md
@@ -1,5 +1,6 @@
---
title: fail - Microsoft Style Guide
+description: Describes guidelines to use 'fail' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/family.md b/styleguide/a-z-word-list-term-collections/f/family.md
index ad5f9ffa..d6fce8f0 100644
--- a/styleguide/a-z-word-list-term-collections/f/family.md
+++ b/styleguide/a-z-word-list-term-collections/f/family.md
@@ -1,5 +1,6 @@
---
title: family - Microsoft Style Guide
+description: Describes guidelines to use 'family' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/far-east.md b/styleguide/a-z-word-list-term-collections/f/far-east.md
index e9acd8d2..9b78e53d 100644
--- a/styleguide/a-z-word-list-term-collections/f/far-east.md
+++ b/styleguide/a-z-word-list-term-collections/f/far-east.md
@@ -1,5 +1,6 @@
---
title: Far East - Microsoft Style Guide
+description: Describes guidelines to use 'Far East' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/far-left-far-right.md b/styleguide/a-z-word-list-term-collections/f/far-left-far-right.md
index 073c85b5..b418257b 100644
--- a/styleguide/a-z-word-list-term-collections/f/far-left-far-right.md
+++ b/styleguide/a-z-word-list-term-collections/f/far-left-far-right.md
@@ -1,5 +1,6 @@
---
title: far-left, far-right - Microsoft Style Guide
+description: Describes guidelines to use 'far-left' or 'far-right' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/favorite.md b/styleguide/a-z-word-list-term-collections/f/favorite.md
index eda14df9..9416ba04 100644
--- a/styleguide/a-z-word-list-term-collections/f/favorite.md
+++ b/styleguide/a-z-word-list-term-collections/f/favorite.md
@@ -1,5 +1,6 @@
---
title: favorite - Microsoft Style Guide
+description: Describes guidelines to use 'favorite' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/fax.md b/styleguide/a-z-word-list-term-collections/f/fax.md
index 6f48c4f2..33241686 100644
--- a/styleguide/a-z-word-list-term-collections/f/fax.md
+++ b/styleguide/a-z-word-list-term-collections/f/fax.md
@@ -1,5 +1,6 @@
---
title: fax - Microsoft Style Guide
+description: Describes guidelines to use 'fax' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/field.md b/styleguide/a-z-word-list-term-collections/f/field.md
index 05994f63..f559c985 100644
--- a/styleguide/a-z-word-list-term-collections/f/field.md
+++ b/styleguide/a-z-word-list-term-collections/f/field.md
@@ -1,5 +1,6 @@
---
title: field - Microsoft Style Guide
+description: Describes guidelines to use 'field' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/file-attributes.md b/styleguide/a-z-word-list-term-collections/f/file-attributes.md
index d30e9b40..aacf0c05 100644
--- a/styleguide/a-z-word-list-term-collections/f/file-attributes.md
+++ b/styleguide/a-z-word-list-term-collections/f/file-attributes.md
@@ -1,5 +1,6 @@
---
title: file attributes - Microsoft Style Guide
+description: Describes guidelines to use file attributes in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/file-explorer.md b/styleguide/a-z-word-list-term-collections/f/file-explorer.md
index 09324bac..10867c6a 100644
--- a/styleguide/a-z-word-list-term-collections/f/file-explorer.md
+++ b/styleguide/a-z-word-list-term-collections/f/file-explorer.md
@@ -1,5 +1,6 @@
---
title: File Explorer - Microsoft Style Guide
+description: Describes guidelines to refer to 'File Explorer' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/file-name-extension-extension.md b/styleguide/a-z-word-list-term-collections/f/file-name-extension-extension.md
index 6a7beb4f..7320727f 100644
--- a/styleguide/a-z-word-list-term-collections/f/file-name-extension-extension.md
+++ b/styleguide/a-z-word-list-term-collections/f/file-name-extension-extension.md
@@ -1,5 +1,6 @@
---
title: file name extension, extension - Microsoft Style Guide
+description: Describes guidelines to use 'file name extension' or 'extension' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/file-name.md b/styleguide/a-z-word-list-term-collections/f/file-name.md
index 1d3017b7..56926b4d 100644
--- a/styleguide/a-z-word-list-term-collections/f/file-name.md
+++ b/styleguide/a-z-word-list-term-collections/f/file-name.md
@@ -1,5 +1,6 @@
---
title: file name - Microsoft Style Guide
+description: Describes guidelines to use 'file name' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/file.md b/styleguide/a-z-word-list-term-collections/f/file.md
index 0db3f424..c0f34d70 100644
--- a/styleguide/a-z-word-list-term-collections/f/file.md
+++ b/styleguide/a-z-word-list-term-collections/f/file.md
@@ -1,5 +1,6 @@
---
title: file - Microsoft Style Guide
+description: Describes guidelines to use 'file' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/finalize.md b/styleguide/a-z-word-list-term-collections/f/finalize.md
index c42e9a4a..5c7055b4 100644
--- a/styleguide/a-z-word-list-term-collections/f/finalize.md
+++ b/styleguide/a-z-word-list-term-collections/f/finalize.md
@@ -1,5 +1,6 @@
---
title: finalize - Microsoft Style Guide
+description: Describes guidelines to use 'finalize' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/f/find-replace.md b/styleguide/a-z-word-list-term-collections/f/find-replace.md
index ef91fcb2..1db6d529 100644
--- a/styleguide/a-z-word-list-term-collections/f/find-replace.md
+++ b/styleguide/a-z-word-list-term-collections/f/find-replace.md
@@ -1,5 +1,6 @@
---
title: find and replace - Microsoft Style Guide
+description: Describes guidelines to use 'find and replace' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 3713c3cfc0e22c1a8d67c117286c976b3cf5fbbe Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Thu, 2 Jun 2022 15:39:55 -0500
Subject: [PATCH 202/486] Added Missing Descriptions
---
.../a-z-word-list-term-collections/t/turn-on-turn-off.md | 1 +
styleguide/a-z-word-list-term-collections/t/type.md | 1 +
.../term-collections/accessibility-terms.md | 3 ++-
.../term-collections/bits-bytes-terms.md | 3 ++-
.../term-collections/cloud-computing-terms.md | 3 ++-
.../term-collections/computer-device-terms.md | 3 ++-
.../term-collections/date-time-terms.md | 3 ++-
.../term-collections/keys-keyboard-shortcuts.md | 3 ++-
.../term-collections/security-terms.md | 3 ++-
.../term-collections/special-characters.md | 1 +
.../term-collections/touch-pen-interaction-terms.md | 3 ++-
.../term-collections/units-of-measure-terms.md | 1 +
styleguide/a-z-word-list-term-collections/u/uk.md | 1 +
styleguide/a-z-word-list-term-collections/u/ultrabook.md | 1 +
styleguide/a-z-word-list-term-collections/u/un.md | 1 +
styleguide/a-z-word-list-term-collections/u/unavailable.md | 1 +
.../u/uncheck-unmark-unselect.md | 1 +
styleguide/a-z-word-list-term-collections/u/undelete.md | 1 +
.../u/underline-vs-underscore.md | 1 +
styleguide/a-z-word-list-term-collections/u/undo.md | 1 +
styleguide/a-z-word-list-term-collections/u/uninstall.md | 1 +
styleguide/a-z-word-list-term-collections/u/unregister.md | 1 +
.../a-z-word-list-term-collections/u/unwanted-software.md | 1 +
styleguide/a-z-word-list-term-collections/u/upgrade.md | 1 +
styleguide/a-z-word-list-term-collections/u/upload.md | 1 +
styleguide/a-z-word-list-term-collections/u/upnp.md | 1 +
.../a-z-word-list-term-collections/u/upper-left-upper-right.md | 1 +
styleguide/a-z-word-list-term-collections/u/uppercase.md | 1 +
styleguide/a-z-word-list-term-collections/u/upsize.md | 1 +
styleguide/a-z-word-list-term-collections/u/upward.md | 1 +
30 files changed, 38 insertions(+), 8 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
index e37d0c8f..aa8a1921 100644
--- a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
+++ b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
@@ -1,5 +1,6 @@
---
title: turn on, turn off - Microsoft Style Guide
+description: Describes how to use turn on and turn off as terminology in Microsoft articles and provides examples of using these terms in content.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/t/type.md b/styleguide/a-z-word-list-term-collections/t/type.md
index 206dc754..a6b13925 100644
--- a/styleguide/a-z-word-list-term-collections/t/type.md
+++ b/styleguide/a-z-word-list-term-collections/t/type.md
@@ -1,5 +1,6 @@
---
title: type - Microsoft Style Guide
+description: Describe the Type term and provides a link to the Describing interactions with UI topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index f1630b7a..cbf82e70 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -1,5 +1,6 @@
---
title: Accessibility terms - Microsoft Style Guide
+description: Describes accessibility terms and provides examples of inclusive language to include in content and examples of sensitive language to exclude from content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -34,7 +35,7 @@ For an overview of Microsoft accessibility policies, see [Accessibility guidelin
To learn more about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
-| **Use this** | **Instead of this** |
+| Use this | Instead of this |
|-----------------------------------------------------------------------------------|-----------------------------------------------------------------------|
| Blind, has low vision | Sight-impaired, vision-impaired |
| Deaf or hard-of-hearing | Hearing-impaired |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md
index 879e6aae..ecb1d0f5 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md
@@ -1,5 +1,6 @@
---
title: Bits and bytes terms - Microsoft Style Guide
+description: Describes how to use the bit and byte terms and provides examples and abbreviations for various instances of referring to bits and bytes in content.
author: pallep
ms.author: pallep
ms.date: 03/31/2021
@@ -44,7 +45,7 @@ a 650-MB limit
1,024 MB
-| **Term** | **Abbreviation** | **Usage** |
+| Term | Abbreviation | Usage |
|--------------------------|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **bits per pixel** | bpp | |
| **bits per second** | bps | Don't use as a synonym for *baud.* See [Units of measure term collection](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) for information about *baud.* |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
index b89a4c3a..e3127515 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md
@@ -1,5 +1,6 @@
---
title: Cloud-computing terms - Microsoft Style Guide
+description: Describes how to include cloud-computing terms in Microsoft content and provides a table that outlines the usage for various cloud-computing terms.
author: pallep
ms.author: pallep
ms.date: 12/13/2021
@@ -20,7 +21,7 @@ For more
information about creating new terms or using emerging terminology, see [Use technical terms carefully](~/word-choice/use-technical-terms-carefully.md).
-| **Term** | **Usage** |
+| Term | Usage |
|-------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **as a service (-aaS)** | Use only *as a service (-aaS)* terms included in this term list.
Don’t create new *as a service* terms or *-aaS* acronyms. Instead, describe the service and what it provides the customer.
| **cloud, the cloud** | Don't capitalize *cloud* except in references to the Microsoft Cloud or when it's part of a product name.
Use *cloud* mostly as an adjective. Use sparingly as a noun—instead of *the cloud*, talk about *cloud computing*, *cloud services*, or a specific service or functionality and what the customer can do with it. |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/computer-device-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/computer-device-terms.md
index 30ff8d1c..ea258965 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/computer-device-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/computer-device-terms.md
@@ -1,5 +1,6 @@
---
title: Computer and device terms - Microsoft Style Guide
+description: Describes how to implement computer and device terms in Microsoft content and provides a table that outlines the usage of various computer and device terms.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
@@ -28,7 +29,7 @@ Use these verbs to talk about using devices and peripheral devices:
## Preferred device terms
-| **Term** | **Usage** |
+| Term | Usage |
|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **device, mobile device** | Use *device* to refer collectively to all types of computers, phones, and other devices.
Use *mobile device* only when you need to call out the mobility.
It's OK to modify *device* when it matters. For example, *point-of-sale device*. |
| **computer, PC** | Use *computer* when you need to talk about a computing device other than a phone, wearable device, or gaming console.
It's OK to use *PC* when space is a constraint, but don't switch between *PC* and *computer*.
Don't use *mobile computer,* *portable computer,* or *mobile PC.* |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 8c52c680..e0a8d983 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -1,5 +1,6 @@
---
title: Date and time terms - Microsoft Style Guide
+description: Describes how to implement date and time terms and provides a table that outlines the usage for various date and time terms.
author: pallep
ms.author: pallep
ms.date: 08/10/2021
@@ -12,7 +13,7 @@ ms.prod: non-product-specific
This section covers usage for terms related to time and date.
-| **Term** | **Usage** |
+| Term | Usage |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
index a8f5f9af..d478012a 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
@@ -1,5 +1,6 @@
---
title: Keys and keyboard shortcuts - Microsoft Style Guide
+description: Describes how to refer to keys and keyboard shortcuts in Microsoft content and provides a list that outlines usage for various keyboard actions and access.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
@@ -15,7 +16,7 @@ For information about describing customers' interactions with UI, see [Procedure
## Keyboard actions and access
-| **Term** | **Usage** |
+| Term | Usage |
|---------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **keyboard shortcut, accelerator key, fast key, hot key, quick key, speed key** | In general, use *keyboard shortcut* to describe a combination of keystrokes used to perform a task. **Example** Alt+Ctrl+S
Don't use *accelerator key, fast key, hot key, quick key,* or *speed key.* |
| **access key** | Don't use in content for a general audience. Use *keyboard shortcut* instead.
In content for developers or content about customizing the UI, it's OK to distinguish between an *access key* and a *shortcut key*. An access key is a letter or number that users select to access UI controls that have text labels. For example, the *F* in Alt+F. A shortcut key is a key or key combination that users select to perform a common action. For example, Ctrl+V. If you use these terms, explain the difference. |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/security-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/security-terms.md
index 27282b16..6d3c476a 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/security-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/security-terms.md
@@ -1,5 +1,6 @@
---
title: Security terms - Microsoft Style Guide
+description: Describes how to implement security terms in Microsoft content and provides a table that outlines usage for various security terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -12,7 +13,7 @@ ms.prod: non-product-specific
This section describes usage for specific security terms. For definitions of security terms, see the [Microsoft Malware Protection Glossary](https://www.microsoft.com/security/portal/mmpc/shared/glossary.aspx).
-| **Term** | **Usage** |
+| Term | Usage |
|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **antimalware** | Use only as an adjective to describe a category of software used to detect and respond to malicious software, such as viruses, worms, trojans, and sometimes spyware and adware. |
| **antiphishing** | Use only as an adjective to describe practices or a category of software used to detect and respond to phishing scams, which are attempts to trick individuals into revealing sensitive information, such as passwords or credit card numbers. |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/special-characters.md b/styleguide/a-z-word-list-term-collections/term-collections/special-characters.md
index 724df3fa..00e02f9a 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/special-characters.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/special-characters.md
@@ -1,5 +1,6 @@
---
title: Special characters - Microsoft Style Guide
+description: Describes how to refer to special characters in Microsoft content and provides a table that outlines the name for various special characters.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/touch-pen-interaction-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/touch-pen-interaction-terms.md
index dde0546f..41f1635f 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/touch-pen-interaction-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/touch-pen-interaction-terms.md
@@ -1,5 +1,6 @@
---
title: Touch and pen interaction terms - Microsoft Style Guide
+description: Describes how to refer to touch and pen interactions and provides a list that outlines the usage for various touch and pen interaction terms.
author: pallep
ms.author: pallep
ms.date: 09/21/2019
@@ -21,7 +22,7 @@ In general, use input-neutral terms, which support all input methods. If you're
When you need to write specifically about touch and pen UI interactions, use these terms.
-| **Term** | **Usage** |
+| Term | Usage |
|----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **tap** | Use to describe selecting, opening, or activating a button, icon, or other element on the screen with a finger or the pen by tapping it once. Don’t use *tap on*. |
| **double-tap** | Use to describe selecting, opening, or activating a button, icon, or other element on the screen by tapping twice in rapid succession. Hyphenate. Don’t use *double-tap on*. |
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
index e4791faf..ceddfe70 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md
@@ -1,5 +1,6 @@
---
title: Units of measure terms - Microsoft Style Guide
+description: Describes how to refer to units of measure in Microsoft content and provides a table that outlines how to write terms and abbreviations for units of measure.
author: pallep
ms.author: pallep
ms.date: 08/09/2021
diff --git a/styleguide/a-z-word-list-term-collections/u/uk.md b/styleguide/a-z-word-list-term-collections/u/uk.md
index 4b92f9d4..0885202c 100644
--- a/styleguide/a-z-word-list-term-collections/u/uk.md
+++ b/styleguide/a-z-word-list-term-collections/u/uk.md
@@ -1,5 +1,6 @@
---
title: UK - Microsoft Style Guide
+description: Describes how to implement the abbreviation 'UK' in Microsoft Content and advises to avoid using UK as an abbreviation for United Kingdom.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/ultrabook.md b/styleguide/a-z-word-list-term-collections/u/ultrabook.md
index 3cb8cf97..a48f98ed 100644
--- a/styleguide/a-z-word-list-term-collections/u/ultrabook.md
+++ b/styleguide/a-z-word-list-term-collections/u/ultrabook.md
@@ -1,5 +1,6 @@
---
title: Ultrabook - Microsoft Style Guide
+description: Describes how to implement the Ultrabook term in Microsoft content and provides the computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/un.md b/styleguide/a-z-word-list-term-collections/u/un.md
index 206bc764..d16e664a 100644
--- a/styleguide/a-z-word-list-term-collections/u/un.md
+++ b/styleguide/a-z-word-list-term-collections/u/un.md
@@ -1,5 +1,6 @@
---
title: un- - Microsoft Style Guide
+description: Describes how to implement the 'un-' hyphen in Microsoft content and provides a link to the Hyphens topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/unavailable.md b/styleguide/a-z-word-list-term-collections/u/unavailable.md
index 57f57946..60a2f11a 100644
--- a/styleguide/a-z-word-list-term-collections/u/unavailable.md
+++ b/styleguide/a-z-word-list-term-collections/u/unavailable.md
@@ -1,5 +1,6 @@
---
title: unavailable - Microsoft Style Guide
+description: Describes the use of the term 'unavailable' in Microsoft content and provides examples of using the term 'unavailable' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/uncheck-unmark-unselect.md b/styleguide/a-z-word-list-term-collections/u/uncheck-unmark-unselect.md
index cd34ae88..248b8065 100644
--- a/styleguide/a-z-word-list-term-collections/u/uncheck-unmark-unselect.md
+++ b/styleguide/a-z-word-list-term-collections/u/uncheck-unmark-unselect.md
@@ -1,5 +1,6 @@
---
title: uncheck, unmark, unselect - Microsoft Style Guide
+description: Describes how to implement the terms 'uncheck', 'unmark', and 'unselect' in Microsoft content. Use the term 'clear' in place of these terms.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/u/undelete.md b/styleguide/a-z-word-list-term-collections/u/undelete.md
index 4145e9eb..55044fa9 100644
--- a/styleguide/a-z-word-list-term-collections/u/undelete.md
+++ b/styleguide/a-z-word-list-term-collections/u/undelete.md
@@ -1,5 +1,6 @@
---
title: undelete - Microsoft Style Guide
+description: Describes how to implement the term 'undelete' in Microsoft Content and advises to not use the term. Provides a link to the restore topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/underline-vs-underscore.md b/styleguide/a-z-word-list-term-collections/u/underline-vs-underscore.md
index 3608c13a..52efe9b4 100644
--- a/styleguide/a-z-word-list-term-collections/u/underline-vs-underscore.md
+++ b/styleguide/a-z-word-list-term-collections/u/underline-vs-underscore.md
@@ -1,5 +1,6 @@
---
title: underline vs. underscore - Microsoft Style Guide
+description: Describes how to implement underlining and underscoring in Microsoft content and when it is best to use one option over another.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/undo.md b/styleguide/a-z-word-list-term-collections/u/undo.md
index a7e2216d..b160f1d5 100644
--- a/styleguide/a-z-word-list-term-collections/u/undo.md
+++ b/styleguide/a-z-word-list-term-collections/u/undo.md
@@ -1,5 +1,6 @@
---
title: undo - Microsoft Style Guide
+description: Describes how to implement the term 'undo' in Microsoft content and provides examples of implementation of the term 'undo' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/uninstall.md b/styleguide/a-z-word-list-term-collections/u/uninstall.md
index 2a9b8fd7..a9eb58c3 100644
--- a/styleguide/a-z-word-list-term-collections/u/uninstall.md
+++ b/styleguide/a-z-word-list-term-collections/u/uninstall.md
@@ -1,5 +1,6 @@
---
title: uninstall - Microsoft Style Guide
+description: Describes how to implement the term 'uninstall' in Microsoft content and provides a link to the remove topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/unregister.md b/styleguide/a-z-word-list-term-collections/u/unregister.md
index 9ab2f61f..ab8a79a5 100644
--- a/styleguide/a-z-word-list-term-collections/u/unregister.md
+++ b/styleguide/a-z-word-list-term-collections/u/unregister.md
@@ -1,5 +1,6 @@
---
title: unregister - Microsoft Style Guide
+description: Describes how to implement the term 'unregister' in Microsoft content and outlines when to use the term for general audiences and developers.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/unwanted-software.md b/styleguide/a-z-word-list-term-collections/u/unwanted-software.md
index b908278f..27d6b829 100644
--- a/styleguide/a-z-word-list-term-collections/u/unwanted-software.md
+++ b/styleguide/a-z-word-list-term-collections/u/unwanted-software.md
@@ -1,5 +1,6 @@
---
title: unwanted software - Microsoft Style Guide
+description: Provides a link to the security term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upgrade.md b/styleguide/a-z-word-list-term-collections/u/upgrade.md
index 67d2d504..10b2bce2 100644
--- a/styleguide/a-z-word-list-term-collections/u/upgrade.md
+++ b/styleguide/a-z-word-list-term-collections/u/upgrade.md
@@ -1,5 +1,6 @@
---
title: upgrade - Microsoft Style Guide
+description: Describes how to implement the term 'upgrade' in Microsoft content and provides examples of using the term 'upgrade' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upload.md b/styleguide/a-z-word-list-term-collections/u/upload.md
index 22a7f0b5..e1e3785e 100644
--- a/styleguide/a-z-word-list-term-collections/u/upload.md
+++ b/styleguide/a-z-word-list-term-collections/u/upload.md
@@ -1,5 +1,6 @@
---
title: upload - Microsoft Style Guide
+description: Describes how to implement the term 'upload' in Microsoft content and provides an example of using the term 'upload' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upnp.md b/styleguide/a-z-word-list-term-collections/u/upnp.md
index 9fdf3422..e9aabb20 100644
--- a/styleguide/a-z-word-list-term-collections/u/upnp.md
+++ b/styleguide/a-z-word-list-term-collections/u/upnp.md
@@ -1,5 +1,6 @@
---
title: UPnP - Microsoft Style Guide
+description: Describes how to implement using UPnP in Microsoft content and provides examples of using UPnP in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upper-left-upper-right.md b/styleguide/a-z-word-list-term-collections/u/upper-left-upper-right.md
index f4445e6f..8d4490e3 100644
--- a/styleguide/a-z-word-list-term-collections/u/upper-left-upper-right.md
+++ b/styleguide/a-z-word-list-term-collections/u/upper-left-upper-right.md
@@ -1,5 +1,6 @@
---
title: upper left, upper right - Microsoft Style Guide
+description: Describes how to implement the terms 'upper-left' and 'upper-right' in Microsoft content and provides an example of using 'upper-right' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/uppercase.md b/styleguide/a-z-word-list-term-collections/u/uppercase.md
index cb7b4740..a6edecf5 100644
--- a/styleguide/a-z-word-list-term-collections/u/uppercase.md
+++ b/styleguide/a-z-word-list-term-collections/u/uppercase.md
@@ -1,5 +1,6 @@
---
title: uppercase - Microsoft Style Guide
+description: Describes how to implement the term 'uppercase' in Microsoft content and provides examples of using 'uppercase' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upsize.md b/styleguide/a-z-word-list-term-collections/u/upsize.md
index e66a9af7..5445ee43 100644
--- a/styleguide/a-z-word-list-term-collections/u/upsize.md
+++ b/styleguide/a-z-word-list-term-collections/u/upsize.md
@@ -1,5 +1,6 @@
---
title: upsize - Microsoft Style Guide
+description: Describes lack of implementation of the term 'upsize' in Microsoft content. Advises to use the term 'scale up' in place of the term 'upsize'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/upward.md b/styleguide/a-z-word-list-term-collections/u/upward.md
index dfdeb8b3..339a14ca 100644
--- a/styleguide/a-z-word-list-term-collections/u/upward.md
+++ b/styleguide/a-z-word-list-term-collections/u/upward.md
@@ -1,5 +1,6 @@
---
title: upward - Microsoft Style Guide
+description: Describes how to implement the term 'upward' in Microsoft content. Advises to use in place of the term 'upwards'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 84d29c00341ee154a7f0ef1919de21581cf5e0cd Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Thu, 2 Jun 2022 16:15:28 -0500
Subject: [PATCH 203/486] Added Missing Descriptions
---
styleguide/a-z-word-list-term-collections/u/url.md | 1 +
styleguide/a-z-word-list-term-collections/u/us.md | 1 +
styleguide/a-z-word-list-term-collections/u/usable.md | 1 +
styleguide/a-z-word-list-term-collections/u/usb.md | 1 +
styleguide/a-z-word-list-term-collections/u/use-terms.md | 1 +
styleguide/a-z-word-list-term-collections/u/user-end-user.md | 1 +
styleguide/a-z-word-list-term-collections/u/user-rights.md | 1 +
.../a-z-word-list-term-collections/u/using-by-using-with.md | 1 +
styleguide/a-z-word-list-term-collections/u/utility.md | 1 +
styleguide/a-z-word-list-term-collections/v/value-axis.md | 1 +
styleguide/a-z-word-list-term-collections/v/versus-vs.md | 1 +
.../v/video-call-videoconference.md | 1 +
styleguide/a-z-word-list-term-collections/v/video-card.md | 1 +
styleguide/a-z-word-list-term-collections/v/video-display.md | 1 +
styleguide/a-z-word-list-term-collections/v/video-driver.md | 1 +
styleguide/a-z-word-list-term-collections/v/video-game.md | 1 +
styleguide/a-z-word-list-term-collections/v/virtual-agent.md | 1 +
styleguide/a-z-word-list-term-collections/v/virtual.md | 1 +
styleguide/a-z-word-list-term-collections/v/virtualize.md | 1 +
styleguide/a-z-word-list-term-collections/v/visit.md | 1 +
.../a-z-word-list-term-collections/v/voice-activated-device.md | 1 +
.../a-z-word-list-term-collections/v/voice-user-interface-vui.md | 1 +
styleguide/a-z-word-list-term-collections/v/voicemail.md | 1 +
styleguide/a-z-word-list-term-collections/v/vulnerability.md | 1 +
styleguide/a-z-word-list-term-collections/w/w3c.md | 1 +
styleguide/a-z-word-list-term-collections/w/want.md | 1 +
styleguide/a-z-word-list-term-collections/w/we.md | 1 +
.../a-z-word-list-term-collections/w/wearable-wearable-device.md | 1 +
styleguide/a-z-word-list-term-collections/w/web-services.md | 1 +
.../a-z-word-list-term-collections/w/web-world-wide-web-www.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/u/url.md b/styleguide/a-z-word-list-term-collections/u/url.md
index 90c11130..bfebc73e 100644
--- a/styleguide/a-z-word-list-term-collections/u/url.md
+++ b/styleguide/a-z-word-list-term-collections/u/url.md
@@ -1,5 +1,6 @@
---
title: URL - Microsoft Style Guide
+description: Describes how to implement the term 'URL' in Microsoft content and provides an example of using 'URL' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/us.md b/styleguide/a-z-word-list-term-collections/u/us.md
index cc1c3459..948ba6c7 100644
--- a/styleguide/a-z-word-list-term-collections/u/us.md
+++ b/styleguide/a-z-word-list-term-collections/u/us.md
@@ -1,5 +1,6 @@
---
title: US - Microsoft Style Guide
+description: Describes how to implement the term 'US' in Microsoft content and clarifies that 'US' can be used in place of 'United States' in instances of limited space.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/usable.md b/styleguide/a-z-word-list-term-collections/u/usable.md
index 9e3dc2ff..20757b02 100644
--- a/styleguide/a-z-word-list-term-collections/u/usable.md
+++ b/styleguide/a-z-word-list-term-collections/u/usable.md
@@ -1,5 +1,6 @@
---
title: usable - Microsoft Style Guide
+description: Describes how to implement the term 'useable' in Microsoft content instead of using the term 'usable'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/usb.md b/styleguide/a-z-word-list-term-collections/u/usb.md
index 56b3cd57..cd1e3109 100644
--- a/styleguide/a-z-word-list-term-collections/u/usb.md
+++ b/styleguide/a-z-word-list-term-collections/u/usb.md
@@ -1,5 +1,6 @@
---
title: USB - Microsoft Style Guide
+description: Provides the computer and device term collection topic to learn how to implement the term 'USB' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/u/use-terms.md b/styleguide/a-z-word-list-term-collections/u/use-terms.md
index 1634b3af..914b8b1e 100644
--- a/styleguide/a-z-word-list-term-collections/u/use-terms.md
+++ b/styleguide/a-z-word-list-term-collections/u/use-terms.md
@@ -1,5 +1,6 @@
---
title: use terms - Microsoft Style Guide
+description: Describes how to implement the term 'use terms' in Microsoft content and provides the Microsoft Software License Terms topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/user-end-user.md b/styleguide/a-z-word-list-term-collections/u/user-end-user.md
index 8837bdf1..3762c360 100644
--- a/styleguide/a-z-word-list-term-collections/u/user-end-user.md
+++ b/styleguide/a-z-word-list-term-collections/u/user-end-user.md
@@ -1,5 +1,6 @@
---
title: user, end user - Microsoft Style Guide
+description: Describes how to implement the terms 'user' and 'end user' in Microsoft content and clarifies to avoid using the term 'user' when possible.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/user-rights.md b/styleguide/a-z-word-list-term-collections/u/user-rights.md
index 579d6430..9fe782c7 100644
--- a/styleguide/a-z-word-list-term-collections/u/user-rights.md
+++ b/styleguide/a-z-word-list-term-collections/u/user-rights.md
@@ -1,5 +1,6 @@
---
title: user rights - Microsoft Style Guide
+description: Describes how to implement the term 'user rights' in Microsoft content and provides examples of using the term 'user rights' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/using-by-using-with.md b/styleguide/a-z-word-list-term-collections/u/using-by-using-with.md
index 0af54953..30eafd29 100644
--- a/styleguide/a-z-word-list-term-collections/u/using-by-using-with.md
+++ b/styleguide/a-z-word-list-term-collections/u/using-by-using-with.md
@@ -1,5 +1,6 @@
---
title: using, by using, with - Microsoft Style Guide
+description: Describes how to implement the terms 'using', 'by using', and 'with' in Microsoft content and provides examples of using these terms in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/u/utility.md b/styleguide/a-z-word-list-term-collections/u/utility.md
index 110a885c..43d07ef7 100644
--- a/styleguide/a-z-word-list-term-collections/u/utility.md
+++ b/styleguide/a-z-word-list-term-collections/u/utility.md
@@ -1,5 +1,6 @@
---
title: utility - Microsoft Style Guide
+description: Describes the lack of the use of the term 'utility' in Microsoft content and provides a list of alternative terms to use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/value-axis.md b/styleguide/a-z-word-list-term-collections/v/value-axis.md
index 5a4e0254..568a90e9 100644
--- a/styleguide/a-z-word-list-term-collections/v/value-axis.md
+++ b/styleguide/a-z-word-list-term-collections/v/value-axis.md
@@ -1,5 +1,6 @@
---
title: value axis - Microsoft Style Guide
+description: Describes how to implement the term 'value axis' in Microsoft content and provides a link to the category axis topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/versus-vs.md b/styleguide/a-z-word-list-term-collections/v/versus-vs.md
index 9bc97bed..cea7f44b 100644
--- a/styleguide/a-z-word-list-term-collections/v/versus-vs.md
+++ b/styleguide/a-z-word-list-term-collections/v/versus-vs.md
@@ -1,5 +1,6 @@
---
title: versus, vs. - Microsoft Style Guide
+description: Describes how to implement the terms 'versus' and 'vs.' in Microsoft content and clarifies when to use each version of the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/video-call-videoconference.md b/styleguide/a-z-word-list-term-collections/v/video-call-videoconference.md
index 51bd59a9..bfa05886 100644
--- a/styleguide/a-z-word-list-term-collections/v/video-call-videoconference.md
+++ b/styleguide/a-z-word-list-term-collections/v/video-call-videoconference.md
@@ -1,5 +1,6 @@
---
title: video call, videoconference - Microsoft Style Guide
+description: Describes how to implement the terms 'video call', 'videoconference', 'call', and 'meeting' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/video-card.md b/styleguide/a-z-word-list-term-collections/v/video-card.md
index 33850989..56e7ffcb 100644
--- a/styleguide/a-z-word-list-term-collections/v/video-card.md
+++ b/styleguide/a-z-word-list-term-collections/v/video-card.md
@@ -1,5 +1,6 @@
---
title: video card - Microsoft Style Guide
+description: Describes how to implement the term 'video card' in place of the other terms in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/video-display.md b/styleguide/a-z-word-list-term-collections/v/video-display.md
index 9b8672bb..dc340f26 100644
--- a/styleguide/a-z-word-list-term-collections/v/video-display.md
+++ b/styleguide/a-z-word-list-term-collections/v/video-display.md
@@ -1,5 +1,6 @@
---
title: video display - Microsoft Style Guide
+description: Describes how the term 'video display' is not to be used in Microsoft content and provides a link to the computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/video-driver.md b/styleguide/a-z-word-list-term-collections/v/video-driver.md
index 2ac45953..eeef946b 100644
--- a/styleguide/a-z-word-list-term-collections/v/video-driver.md
+++ b/styleguide/a-z-word-list-term-collections/v/video-driver.md
@@ -1,5 +1,6 @@
---
title: video driver - Microsoft Style Guide
+description: Describes how to implement the term 'video driver' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/video-game.md b/styleguide/a-z-word-list-term-collections/v/video-game.md
index b5350b29..0cf0dc50 100644
--- a/styleguide/a-z-word-list-term-collections/v/video-game.md
+++ b/styleguide/a-z-word-list-term-collections/v/video-game.md
@@ -1,5 +1,6 @@
---
title: video game, video-game - Microsoft Style Guide
+description: Describes how to implement the terms 'video game' and 'video-game' in Microsoft content and provides examples of using these terms in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/virtual-agent.md b/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
index 85e4b50b..f8693105 100644
--- a/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
+++ b/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
@@ -1,5 +1,6 @@
---
title: virtual agent - Microsoft Style Guide
+description: Provides a link to the AI and bot term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/virtual.md b/styleguide/a-z-word-list-term-collections/v/virtual.md
index 01b634d0..476d8f45 100644
--- a/styleguide/a-z-word-list-term-collections/v/virtual.md
+++ b/styleguide/a-z-word-list-term-collections/v/virtual.md
@@ -1,5 +1,6 @@
---
title: virtual - Microsoft Style Guide
+description: Describes how to implement the term 'virtual' in Microsoft content and provides examples of using the term 'virtual' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/virtualize.md b/styleguide/a-z-word-list-term-collections/v/virtualize.md
index 0fb72a00..03e5ac3f 100644
--- a/styleguide/a-z-word-list-term-collections/v/virtualize.md
+++ b/styleguide/a-z-word-list-term-collections/v/virtualize.md
@@ -1,5 +1,6 @@
---
title: virtualize - Microsoft Style Guide
+description: Describes how to implement the term 'virtualize' in content, clarifying to use the term only for technical audiences.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/visit.md b/styleguide/a-z-word-list-term-collections/v/visit.md
index 2cae6b21..f4a17942 100644
--- a/styleguide/a-z-word-list-term-collections/v/visit.md
+++ b/styleguide/a-z-word-list-term-collections/v/visit.md
@@ -1,5 +1,6 @@
---
title: visit - Microsoft Style Guide
+description: Describes how to implement the term 'visit' in Microsoft content and provides a link to the describing interactions with UI topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md b/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
index 4a30bbb0..f97c7f6a 100644
--- a/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
+++ b/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
@@ -1,5 +1,6 @@
---
title: voice-activated device - Microsoft Style Guide
+description: Provides a link to the AI and bot term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md b/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
index d1e5fb8f..f3223b6b 100644
--- a/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
+++ b/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
@@ -1,5 +1,6 @@
---
title: voice user interface (VUI) - Microsoft Style Guide
+description: Provides a link to the AI and bot term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/voicemail.md b/styleguide/a-z-word-list-term-collections/v/voicemail.md
index 773912c2..37b47e4f 100644
--- a/styleguide/a-z-word-list-term-collections/v/voicemail.md
+++ b/styleguide/a-z-word-list-term-collections/v/voicemail.md
@@ -1,5 +1,6 @@
---
title: voicemail - Microsoft Style Guide
+description: Describes how to implement the term 'voicemail' in Microsoft content and provides examples of using the term 'voicemail' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/vulnerability.md b/styleguide/a-z-word-list-term-collections/v/vulnerability.md
index 584b47cc..2237ae57 100644
--- a/styleguide/a-z-word-list-term-collections/v/vulnerability.md
+++ b/styleguide/a-z-word-list-term-collections/v/vulnerability.md
@@ -1,5 +1,6 @@
---
title: vulnerability - Microsoft Style Guide
+description: Provides a link to the security term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/w/w3c.md b/styleguide/a-z-word-list-term-collections/w/w3c.md
index 087408e0..98ef26f9 100644
--- a/styleguide/a-z-word-list-term-collections/w/w3c.md
+++ b/styleguide/a-z-word-list-term-collections/w/w3c.md
@@ -1,5 +1,6 @@
---
title: W3C - Microsoft Style Guide
+description: Describes that the term 'W3C' is not to be spelled out in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/w/want.md b/styleguide/a-z-word-list-term-collections/w/want.md
index e17a25ad..c9d5a954 100644
--- a/styleguide/a-z-word-list-term-collections/w/want.md
+++ b/styleguide/a-z-word-list-term-collections/w/want.md
@@ -1,5 +1,6 @@
---
title: want - Microsoft Style Guide
+description: Describes how to implement the term 'want' in Microsoft content and provides an example of using the term 'want' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/w/we.md b/styleguide/a-z-word-list-term-collections/w/we.md
index 1928fc67..bf086109 100644
--- a/styleguide/a-z-word-list-term-collections/w/we.md
+++ b/styleguide/a-z-word-list-term-collections/w/we.md
@@ -1,5 +1,6 @@
---
title: we - Microsoft Style Guide
+description: Describes how to implement the term 'we' in Microsoft content and provides examples of using the term 'we' in content.
author: pallep
ms.author: pallep
ms.date: 07/17/2018
diff --git a/styleguide/a-z-word-list-term-collections/w/wearable-wearable-device.md b/styleguide/a-z-word-list-term-collections/w/wearable-wearable-device.md
index 886ebb09..4cd1f7bc 100644
--- a/styleguide/a-z-word-list-term-collections/w/wearable-wearable-device.md
+++ b/styleguide/a-z-word-list-term-collections/w/wearable-wearable-device.md
@@ -1,5 +1,6 @@
---
title: wearable, wearable device - Microsoft Style Guide
+description: Provides a link to the computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/w/web-services.md b/styleguide/a-z-word-list-term-collections/w/web-services.md
index 96611f40..000f80e4 100644
--- a/styleguide/a-z-word-list-term-collections/w/web-services.md
+++ b/styleguide/a-z-word-list-term-collections/w/web-services.md
@@ -1,5 +1,6 @@
---
title: web services - Microsoft Style Guide
+description: Describes how to implement the term 'web services' when referring to web-based applications in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/w/web-world-wide-web-www.md b/styleguide/a-z-word-list-term-collections/w/web-world-wide-web-www.md
index 825218b2..434b0680 100644
--- a/styleguide/a-z-word-list-term-collections/w/web-world-wide-web-www.md
+++ b/styleguide/a-z-word-list-term-collections/w/web-world-wide-web-www.md
@@ -1,5 +1,6 @@
---
title: web, World Wide Web, WWW - Microsoft Style Guide
+description: Describes how to implement the terms 'web', 'World Wide Web', and 'WWW' in Microsoft content and provides a link to the URLs and web addresses topic.
author: pallep
ms.author: pallep
ms.date: 08/1/2019
From 663ebc7f518ba30f7f482bec704920947d46ceaa Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Thu, 2 Jun 2022 16:19:40 -0500
Subject: [PATCH 204/486] fixed duplicates
---
styleguide/a-z-word-list-term-collections/v/virtual-agent.md | 2 +-
.../a-z-word-list-term-collections/v/voice-activated-device.md | 2 +-
.../v/voice-user-interface-vui.md | 2 +-
styleguide/a-z-word-list-term-collections/v/vulnerability.md | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/v/virtual-agent.md b/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
index f8693105..cd8a8d97 100644
--- a/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
+++ b/styleguide/a-z-word-list-term-collections/v/virtual-agent.md
@@ -1,6 +1,6 @@
---
title: virtual agent - Microsoft Style Guide
-description: Provides a link to the AI and bot term collection topic.
+description: Provides a link to the AI and bot term collection topic in place of describing how to implement the term 'virtual agent' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md b/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
index f97c7f6a..333179e2 100644
--- a/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
+++ b/styleguide/a-z-word-list-term-collections/v/voice-activated-device.md
@@ -1,6 +1,6 @@
---
title: voice-activated device - Microsoft Style Guide
-description: Provides a link to the AI and bot term collection topic.
+description: Provides a link to the AI and bot term collection topic in place of describing how to implement the term 'voice-activated device' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md b/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
index f3223b6b..605df50e 100644
--- a/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
+++ b/styleguide/a-z-word-list-term-collections/v/voice-user-interface-vui.md
@@ -1,6 +1,6 @@
---
title: voice user interface (VUI) - Microsoft Style Guide
-description: Provides a link to the AI and bot term collection topic.
+description: Provides a link to the AI and bot term collection topic in place of describing how to implement the term 'voice user interface' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/v/vulnerability.md b/styleguide/a-z-word-list-term-collections/v/vulnerability.md
index 2237ae57..03dc556e 100644
--- a/styleguide/a-z-word-list-term-collections/v/vulnerability.md
+++ b/styleguide/a-z-word-list-term-collections/v/vulnerability.md
@@ -1,6 +1,6 @@
---
title: vulnerability - Microsoft Style Guide
-description: Provides a link to the security term collection topic.
+description: Provides a link to the AI and bot term collection topic in place of describing how to implement the term 'vulnerability' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 87b2b38cbfebe6ccad34fbe9fc99a0ced16b4f6f Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Thu, 2 Jun 2022 16:30:50 -0500
Subject: [PATCH 205/486] description fix
---
styleguide/a-z-word-list-term-collections/u/usable.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/u/usable.md b/styleguide/a-z-word-list-term-collections/u/usable.md
index 20757b02..d7461a89 100644
--- a/styleguide/a-z-word-list-term-collections/u/usable.md
+++ b/styleguide/a-z-word-list-term-collections/u/usable.md
@@ -1,6 +1,6 @@
---
title: usable - Microsoft Style Guide
-description: Describes how to implement the term 'useable' in Microsoft content instead of using the term 'usable'.
+description: Describes how to implement the term 'usable' in Microsoft content instead of using the term 'useable'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 730378112b6bba795f854bf6a5fed840b98e4003 Mon Sep 17 00:00:00 2001
From: brittmsantos <104656243+brittmsantos@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:21:25 -0400
Subject: [PATCH 206/486] description-missing fixes.
---
styleguide/a-z-word-list-term-collections/c/clickstream.md | 1 +
styleguide/a-z-word-list-term-collections/c/clickthrough.md | 1 +
styleguide/a-z-word-list-term-collections/c/client-server.md | 1 +
styleguide/a-z-word-list-term-collections/c/client-side.md | 1 +
styleguide/a-z-word-list-term-collections/c/client.md | 1 +
styleguide/a-z-word-list-term-collections/c/clipboard.md | 1 +
styleguide/a-z-word-list-term-collections/c/close.md | 1 +
styleguide/a-z-word-list-term-collections/c/cloud-platform.md | 1 +
styleguide/a-z-word-list-term-collections/c/cloud-services.md | 1 +
styleguide/a-z-word-list-term-collections/c/cloud.md | 1 +
styleguide/a-z-word-list-term-collections/c/co.md | 1 +
styleguide/a-z-word-list-term-collections/c/code-page.md | 1 +
styleguide/a-z-word-list-term-collections/c/code-point.md | 1 +
styleguide/a-z-word-list-term-collections/c/color-map.md | 1 +
styleguide/a-z-word-list-term-collections/c/column-format.md | 1 +
styleguide/a-z-word-list-term-collections/c/combo-box.md | 1 +
styleguide/a-z-word-list-term-collections/c/command-button.md | 1 +
styleguide/a-z-word-list-term-collections/c/command-line.md | 1 +
styleguide/a-z-word-list-term-collections/c/command-prompt.md | 1 +
styleguide/a-z-word-list-term-collections/c/command.md | 1 +
styleguide/a-z-word-list-term-collections/c/community-cloud.md | 1 +
.../a-z-word-list-term-collections/c/company-vs-organization.md | 1 +
styleguide/a-z-word-list-term-collections/c/compile.md | 1 +
styleguide/a-z-word-list-term-collections/c/compute.md | 1 +
styleguide/a-z-word-list-term-collections/c/computer.md | 1 +
styleguide/a-z-word-list-term-collections/c/connect.md | 1 +
styleguide/a-z-word-list-term-collections/c/console.md | 1 +
styleguide/a-z-word-list-term-collections/c/context-sensitive.md | 1 +
.../a-z-word-list-term-collections/c/contiguous-selection.md | 1 +
styleguide/a-z-word-list-term-collections/c/control.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/c/clickstream.md b/styleguide/a-z-word-list-term-collections/c/clickstream.md
index 5d461fdc..59850546 100644
--- a/styleguide/a-z-word-list-term-collections/c/clickstream.md
+++ b/styleguide/a-z-word-list-term-collections/c/clickstream.md
@@ -1,5 +1,6 @@
---
title: clickstream - Microsoft Style Guide
+description: Describes how to use the term 'clickstream' in Microsoft content and clarifies how to style it as one word rather than two.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/clickthrough.md b/styleguide/a-z-word-list-term-collections/c/clickthrough.md
index b5714a74..2a78e9d0 100644
--- a/styleguide/a-z-word-list-term-collections/c/clickthrough.md
+++ b/styleguide/a-z-word-list-term-collections/c/clickthrough.md
@@ -1,5 +1,6 @@
---
title: clickthrough - Microsoft Style Guide
+description: Describes how to use the term 'clickthrough' in Microsoft content and clarifies how to style it as one word rather than two.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/client-server.md b/styleguide/a-z-word-list-term-collections/c/client-server.md
index 045cc30d..0607a1c2 100644
--- a/styleguide/a-z-word-list-term-collections/c/client-server.md
+++ b/styleguide/a-z-word-list-term-collections/c/client-server.md
@@ -1,5 +1,6 @@
---
title: client/server - Microsoft Style Guide
+description: Describes how to use the term 'client/server' in Microsoft content and clarifies how to capitalize it if the context requires capitalization.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/client-side.md b/styleguide/a-z-word-list-term-collections/c/client-side.md
index 6e4df896..552ab79f 100644
--- a/styleguide/a-z-word-list-term-collections/c/client-side.md
+++ b/styleguide/a-z-word-list-term-collections/c/client-side.md
@@ -1,5 +1,6 @@
---
title: client side, client-side - Microsoft Style Guide
+description: Describes how to use the term 'client side' in Microsoft content and clarifies how to hyphenate the term depending on context.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/client.md b/styleguide/a-z-word-list-term-collections/c/client.md
index e4d605cd..eb9359b8 100644
--- a/styleguide/a-z-word-list-term-collections/c/client.md
+++ b/styleguide/a-z-word-list-term-collections/c/client.md
@@ -1,5 +1,6 @@
---
title: client - Microsoft Style Guide
+description: Describes how to use the term 'client' in Microsoft content and clarifies how to use it when referring to a person.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/clipboard.md b/styleguide/a-z-word-list-term-collections/c/clipboard.md
index cc9118ca..2a355ae9 100644
--- a/styleguide/a-z-word-list-term-collections/c/clipboard.md
+++ b/styleguide/a-z-word-list-term-collections/c/clipboard.md
@@ -1,5 +1,6 @@
---
title: clipboard - Microsoft Style Guide
+description: Describes how to use the term 'clipboard' in Microsoft content and clarifies how to phrase sentences using the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/close.md b/styleguide/a-z-word-list-term-collections/c/close.md
index 1a5dfbe6..4902f44b 100644
--- a/styleguide/a-z-word-list-term-collections/c/close.md
+++ b/styleguide/a-z-word-list-term-collections/c/close.md
@@ -1,5 +1,6 @@
---
title: close - Microsoft Style Guide
+description: Provides a link to the discussing describing interactions with UI topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cloud-platform.md b/styleguide/a-z-word-list-term-collections/c/cloud-platform.md
index 88d84812..1a56b76d 100644
--- a/styleguide/a-z-word-list-term-collections/c/cloud-platform.md
+++ b/styleguide/a-z-word-list-term-collections/c/cloud-platform.md
@@ -1,5 +1,6 @@
---
title: cloud platform - Microsoft Style Guide
+description: Provides a link to the discussing cloud-computing terms topic as it pertains to the term 'cloud platform'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cloud-services.md b/styleguide/a-z-word-list-term-collections/c/cloud-services.md
index f3ee2c03..5d1616c6 100644
--- a/styleguide/a-z-word-list-term-collections/c/cloud-services.md
+++ b/styleguide/a-z-word-list-term-collections/c/cloud-services.md
@@ -1,5 +1,6 @@
---
title: cloud services - Microsoft Style Guide
+description: Provides a link to the discussing cloud-computing terms topic as it pertains to the term 'cloud services'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cloud.md b/styleguide/a-z-word-list-term-collections/c/cloud.md
index 17b13b66..2db08c9b 100644
--- a/styleguide/a-z-word-list-term-collections/c/cloud.md
+++ b/styleguide/a-z-word-list-term-collections/c/cloud.md
@@ -1,5 +1,6 @@
---
title: cloud - Microsoft Style Guide
+description: Provides a link to the discussing cloud-computing terms topic as it pertains to the term 'cloud'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/co.md b/styleguide/a-z-word-list-term-collections/c/co.md
index fc20fa1c..3547a6a5 100644
--- a/styleguide/a-z-word-list-term-collections/c/co.md
+++ b/styleguide/a-z-word-list-term-collections/c/co.md
@@ -1,5 +1,6 @@
---
title: co- - Microsoft Style Guide
+description: Describes how to use the prefix 'co-' with words in Microsoft content and clarifies when to hyphenate the prefix.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/code-page.md b/styleguide/a-z-word-list-term-collections/c/code-page.md
index efee44a1..8d2e128f 100644
--- a/styleguide/a-z-word-list-term-collections/c/code-page.md
+++ b/styleguide/a-z-word-list-term-collections/c/code-page.md
@@ -1,5 +1,6 @@
---
title: code page - Microsoft Style Guide
+description: Describes how to use the term 'code page' in Microsoft content and clarifies that the term is not a synonym for the term 'character set'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/code-point.md b/styleguide/a-z-word-list-term-collections/c/code-point.md
index 94a900df..abbca5ae 100644
--- a/styleguide/a-z-word-list-term-collections/c/code-point.md
+++ b/styleguide/a-z-word-list-term-collections/c/code-point.md
@@ -1,5 +1,6 @@
---
title: code point - Microsoft Style Guide
+description: Describes how to style the term 'code point' in Microsoft content as two words rather than one.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/color-map.md b/styleguide/a-z-word-list-term-collections/c/color-map.md
index 35b06e9e..63c97978 100644
--- a/styleguide/a-z-word-list-term-collections/c/color-map.md
+++ b/styleguide/a-z-word-list-term-collections/c/color-map.md
@@ -1,5 +1,6 @@
---
title: color map - Microsoft Style Guide
+description: Describes how to style the term 'color map' in Microsoft content as two words rather than one in a specific context.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/column-format.md b/styleguide/a-z-word-list-term-collections/c/column-format.md
index a5f35824..b16900a7 100644
--- a/styleguide/a-z-word-list-term-collections/c/column-format.md
+++ b/styleguide/a-z-word-list-term-collections/c/column-format.md
@@ -1,5 +1,6 @@
---
title: column format - Microsoft Style Guide
+description: Clarifies when to use the term 'column format' instead of 'columnar' or 'columnLike' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/combo-box.md b/styleguide/a-z-word-list-term-collections/c/combo-box.md
index 5d1c090e..29a0a3dd 100644
--- a/styleguide/a-z-word-list-term-collections/c/combo-box.md
+++ b/styleguide/a-z-word-list-term-collections/c/combo-box.md
@@ -1,5 +1,6 @@
---
title: combo box - Microsoft Style Guide
+description: Describes how to use the term 'combo box' in Microsoft content and clarifies the content audience and context that is appropriate for the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/command-button.md b/styleguide/a-z-word-list-term-collections/c/command-button.md
index e6173db5..58dec91d 100644
--- a/styleguide/a-z-word-list-term-collections/c/command-button.md
+++ b/styleguide/a-z-word-list-term-collections/c/command-button.md
@@ -1,5 +1,6 @@
---
title: command button - Microsoft Style Guide
+description: Describes how to use the term 'command button' in Microsoft content and clarifies the content audience and context that is appropriate for the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/command-line.md b/styleguide/a-z-word-list-term-collections/c/command-line.md
index 16f6f57b..9aa8cc7e 100644
--- a/styleguide/a-z-word-list-term-collections/c/command-line.md
+++ b/styleguide/a-z-word-list-term-collections/c/command-line.md
@@ -1,5 +1,6 @@
---
title: command line, command-line - Microsoft Style Guide
+description: Describes how to use the term 'command line' in Microsoft content and clarifies when to hyphenate the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/command-prompt.md b/styleguide/a-z-word-list-term-collections/c/command-prompt.md
index e8068ecb..706dbf9d 100644
--- a/styleguide/a-z-word-list-term-collections/c/command-prompt.md
+++ b/styleguide/a-z-word-list-term-collections/c/command-prompt.md
@@ -1,5 +1,6 @@
---
title: command prompt - Microsoft Style Guide
+description: Describes how to use the term 'command prompt' in Microsoft content and provides an example of using 'command prompt' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/command.md b/styleguide/a-z-word-list-term-collections/c/command.md
index 3569bc7c..182f1fae 100644
--- a/styleguide/a-z-word-list-term-collections/c/command.md
+++ b/styleguide/a-z-word-list-term-collections/c/command.md
@@ -1,5 +1,6 @@
---
title: command - Microsoft Style Guide
+description: Describes how to write about commands on menus and when to use the term instead of 'menu item', 'choice', or 'option'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/community-cloud.md b/styleguide/a-z-word-list-term-collections/c/community-cloud.md
index 7f9c654d..afe6de8d 100644
--- a/styleguide/a-z-word-list-term-collections/c/community-cloud.md
+++ b/styleguide/a-z-word-list-term-collections/c/community-cloud.md
@@ -1,5 +1,6 @@
---
title: community cloud - Microsoft Style Guide
+description: Provides a link to the discussing cloud-computing terms topic as it pertains to the term 'community cloud'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/company-vs-organization.md b/styleguide/a-z-word-list-term-collections/c/company-vs-organization.md
index 2b523980..155a140d 100644
--- a/styleguide/a-z-word-list-term-collections/c/company-vs-organization.md
+++ b/styleguide/a-z-word-list-term-collections/c/company-vs-organization.md
@@ -1,5 +1,6 @@
---
title: company vs. organization - Microsoft Style Guide
+description: Describes when to use the term 'company' instead of 'organization' in Microsoft content depending on the audience and context.
author: pallep
ms.author: pallep
ms.date: 09/11/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/compile.md b/styleguide/a-z-word-list-term-collections/c/compile.md
index ccbb414a..78050e65 100644
--- a/styleguide/a-z-word-list-term-collections/c/compile.md
+++ b/styleguide/a-z-word-list-term-collections/c/compile.md
@@ -1,5 +1,6 @@
---
title: compile - Microsoft Style Guide
+description: Describes how to use the term 'compile' in Microsoft content as an adjective or a verb and provides an example of using the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/compute.md b/styleguide/a-z-word-list-term-collections/c/compute.md
index 24b43301..5e3de33c 100644
--- a/styleguide/a-z-word-list-term-collections/c/compute.md
+++ b/styleguide/a-z-word-list-term-collections/c/compute.md
@@ -1,5 +1,6 @@
---
title: compute - Microsoft Style Guide
+description: Describes how to use the term 'compute' in Microsoft content depending on the audience and provides examples for using the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/computer.md b/styleguide/a-z-word-list-term-collections/c/computer.md
index 2836da58..3ddeeaad 100644
--- a/styleguide/a-z-word-list-term-collections/c/computer.md
+++ b/styleguide/a-z-word-list-term-collections/c/computer.md
@@ -1,5 +1,6 @@
---
title: computer - Microsoft Style Guide
+description: Provides a link to the computer and device term collection topic as it pertains to the term 'computer'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/connect.md b/styleguide/a-z-word-list-term-collections/c/connect.md
index a33057b9..3c252c03 100644
--- a/styleguide/a-z-word-list-term-collections/c/connect.md
+++ b/styleguide/a-z-word-list-term-collections/c/connect.md
@@ -1,5 +1,6 @@
---
title: connect - Microsoft Style Guide
+description: Describes how to use the term 'connect' and similar terms in Microsoft content for attaching a computer to a network.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/console.md b/styleguide/a-z-word-list-term-collections/c/console.md
index a78c0504..9c2f06c3 100644
--- a/styleguide/a-z-word-list-term-collections/c/console.md
+++ b/styleguide/a-z-word-list-term-collections/c/console.md
@@ -1,5 +1,6 @@
---
title: console - Microsoft Style Guide
+description: Describes how to use the term 'console' as part of other terms in specific contexts in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/context-sensitive.md b/styleguide/a-z-word-list-term-collections/c/context-sensitive.md
index 862f37aa..2f644ca6 100644
--- a/styleguide/a-z-word-list-term-collections/c/context-sensitive.md
+++ b/styleguide/a-z-word-list-term-collections/c/context-sensitive.md
@@ -1,5 +1,6 @@
---
title: context-sensitive - Microsoft Style Guide
+description: Explains how to hyphenate the term 'content-sensitive' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/contiguous-selection.md b/styleguide/a-z-word-list-term-collections/c/contiguous-selection.md
index bbf3fbff..26e8e89b 100644
--- a/styleguide/a-z-word-list-term-collections/c/contiguous-selection.md
+++ b/styleguide/a-z-word-list-term-collections/c/contiguous-selection.md
@@ -1,5 +1,6 @@
---
title: contiguous selection - Microsoft Style Guide
+description: Describes how to use other terms instead of the term 'contiguous selection' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/control.md b/styleguide/a-z-word-list-term-collections/c/control.md
index a01048c0..1b4cc3d7 100644
--- a/styleguide/a-z-word-list-term-collections/c/control.md
+++ b/styleguide/a-z-word-list-term-collections/c/control.md
@@ -1,5 +1,6 @@
---
title: control - Microsoft Style Guide
+description: Describes how to use the term 'control' in specific contexts for Microsoft content and provides examples of using the term.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
From 3bb46f7cad8bd52732eb7f36dae798f0eba8895e Mon Sep 17 00:00:00 2001
From: dereklh7 <101607642+dereklh7@users.noreply.github.com>
Date: Thu, 2 Jun 2022 17:53:04 -0500
Subject: [PATCH 207/486] Added Missing Descriptions
---
styleguide/a-z-word-list-term-collections/t/tablet.md | 1 +
.../t/tap-double-tap-tap-and-hold.md | 1 +
.../a-z-word-list-term-collections/t/target-drive-target-file.md | 1 +
styleguide/a-z-word-list-term-collections/t/taskbar.md | 1 +
styleguide/a-z-word-list-term-collections/t/terabyte.md | 1 +
styleguide/a-z-word-list-term-collections/t/terminate.md | 1 +
styleguide/a-z-word-list-term-collections/t/text-box.md | 1 +
styleguide/a-z-word-list-term-collections/t/text-text-message.md | 1 +
styleguide/a-z-word-list-term-collections/t/thanks-thank-you.md | 1 +
styleguide/a-z-word-list-term-collections/t/that-vs-which.md | 1 +
styleguide/a-z-word-list-term-collections/t/thousand-k.md | 1 +
styleguide/a-z-word-list-term-collections/t/tile-live-tile.md | 1 +
styleguide/a-z-word-list-term-collections/t/time-out.md | 1 +
styleguide/a-z-word-list-term-collections/t/time-stamp.md | 1 +
styleguide/a-z-word-list-term-collections/t/to-do.md | 1 +
styleguide/a-z-word-list-term-collections/t/toast.md | 1 +
styleguide/a-z-word-list-term-collections/t/toggle.md | 1 +
styleguide/a-z-word-list-term-collections/t/tone.md | 1 +
styleguide/a-z-word-list-term-collections/t/tool.md | 1 +
styleguide/a-z-word-list-term-collections/t/toolkit.md | 1 +
.../a-z-word-list-term-collections/t/top-left-top-right.md | 1 +
styleguide/a-z-word-list-term-collections/t/top-level-folder.md | 1 +
styleguide/a-z-word-list-term-collections/t/touch-sensitive.md | 1 +
styleguide/a-z-word-list-term-collections/t/touchpad.md | 1 +
styleguide/a-z-word-list-term-collections/t/touchscreen.md | 1 +
styleguide/a-z-word-list-term-collections/t/toward.md | 1 +
styleguide/a-z-word-list-term-collections/t/trackball.md | 1 +
styleguide/a-z-word-list-term-collections/t/trailing.md | 1 +
.../a-z-word-list-term-collections/t/trojan-horse-trojan.md | 1 +
styleguide/a-z-word-list-term-collections/t/turnkey.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/t/tablet.md b/styleguide/a-z-word-list-term-collections/t/tablet.md
index c5d45d63..cf840a5e 100644
--- a/styleguide/a-z-word-list-term-collections/t/tablet.md
+++ b/styleguide/a-z-word-list-term-collections/t/tablet.md
@@ -1,5 +1,6 @@
---
title: tablet - Microsoft Style Guide
+description: In place of describing how to implement the term 'tablet' in Microsoft content, this article provides a link to the computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/tap-double-tap-tap-and-hold.md b/styleguide/a-z-word-list-term-collections/t/tap-double-tap-tap-and-hold.md
index 0810edaf..95b6733d 100644
--- a/styleguide/a-z-word-list-term-collections/t/tap-double-tap-tap-and-hold.md
+++ b/styleguide/a-z-word-list-term-collections/t/tap-double-tap-tap-and-hold.md
@@ -1,5 +1,6 @@
---
title: tap, double-tap, tap and hold - Microsoft Style Guide
+description: In place of describing how to use the term 'tap' in Microsoft content, this article provides a link to the touch and pen interaction term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/target-drive-target-file.md b/styleguide/a-z-word-list-term-collections/t/target-drive-target-file.md
index f57c49bf..e723c6d3 100644
--- a/styleguide/a-z-word-list-term-collections/t/target-drive-target-file.md
+++ b/styleguide/a-z-word-list-term-collections/t/target-drive-target-file.md
@@ -1,5 +1,6 @@
---
title: target drive, target file - Microsoft Style Guide
+description: Describes how to implement the 'target drive' and 'target file' in Microsoft content and provides examples of these terms not being used in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/taskbar.md b/styleguide/a-z-word-list-term-collections/t/taskbar.md
index e3476e34..db6874d6 100644
--- a/styleguide/a-z-word-list-term-collections/t/taskbar.md
+++ b/styleguide/a-z-word-list-term-collections/t/taskbar.md
@@ -1,5 +1,6 @@
---
title: taskbar - Microsoft Style Guide
+description: Describes how to implement the term 'taskbar' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/terabyte.md b/styleguide/a-z-word-list-term-collections/t/terabyte.md
index e2ceb4c2..6ff37560 100644
--- a/styleguide/a-z-word-list-term-collections/t/terabyte.md
+++ b/styleguide/a-z-word-list-term-collections/t/terabyte.md
@@ -1,5 +1,6 @@
---
title: terabyte, TB - Microsoft Style Guide
+description: In place of describing how to use the terms 'terabyte' and 'TB' in content, this article provides a link to the bits and bytes term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/terminate.md b/styleguide/a-z-word-list-term-collections/t/terminate.md
index 4ba0db71..68050893 100644
--- a/styleguide/a-z-word-list-term-collections/t/terminate.md
+++ b/styleguide/a-z-word-list-term-collections/t/terminate.md
@@ -1,5 +1,6 @@
---
title: terminate - Microsoft Style Guide
+description: Describes how to implement the term 'terminate' in Microsoft content and clarifies that this term is OK to use for content for technical audiences.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/text-box.md b/styleguide/a-z-word-list-term-collections/t/text-box.md
index 52ac108f..bd7b8209 100644
--- a/styleguide/a-z-word-list-term-collections/t/text-box.md
+++ b/styleguide/a-z-word-list-term-collections/t/text-box.md
@@ -1,5 +1,6 @@
---
title: text box - Microsoft Style Guide
+description: Describes how to implement the term 'text box' in Microsoft content and provides examples of using the term 'text box' in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/text-text-message.md b/styleguide/a-z-word-list-term-collections/t/text-text-message.md
index 5612a63e..11731c21 100644
--- a/styleguide/a-z-word-list-term-collections/t/text-text-message.md
+++ b/styleguide/a-z-word-list-term-collections/t/text-text-message.md
@@ -1,5 +1,6 @@
---
title: text, text message - Microsoft Style Guide
+description: Describes how to implement the terms 'text' and 'text message' in Microsoft content and provides a link to the message topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/thanks-thank-you.md b/styleguide/a-z-word-list-term-collections/t/thanks-thank-you.md
index 9739a86d..dd132905 100644
--- a/styleguide/a-z-word-list-term-collections/t/thanks-thank-you.md
+++ b/styleguide/a-z-word-list-term-collections/t/thanks-thank-you.md
@@ -1,5 +1,6 @@
---
title: thanks, thank you - Microsoft Style Guide
+description: Describes how to implement the terms 'thanks' and 'thank you' in Microsoft content and provides examples of using these terms in content.
author: pallep
ms.author: pallep
ms.date: 06/26/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/that-vs-which.md b/styleguide/a-z-word-list-term-collections/t/that-vs-which.md
index 3d0fbbd6..010a6e09 100644
--- a/styleguide/a-z-word-list-term-collections/t/that-vs-which.md
+++ b/styleguide/a-z-word-list-term-collections/t/that-vs-which.md
@@ -1,5 +1,6 @@
---
title: that vs. which - Microsoft Style Guide
+description: Describes how to implement the terms 'that' and 'which' in Microsoft content and provides examples of using these terms in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/thousand-k.md b/styleguide/a-z-word-list-term-collections/t/thousand-k.md
index 10ba72b9..2f56951d 100644
--- a/styleguide/a-z-word-list-term-collections/t/thousand-k.md
+++ b/styleguide/a-z-word-list-term-collections/t/thousand-k.md
@@ -1,5 +1,6 @@
---
title: thousand, K - Microsoft Style Guide
+description: In place of describing how to use the term 'K' for the term 'thousand', this article provides a link to the Numbers topic.
author: pallep
ms.author: pallep
ms.date: 09/18/2019
diff --git a/styleguide/a-z-word-list-term-collections/t/tile-live-tile.md b/styleguide/a-z-word-list-term-collections/t/tile-live-tile.md
index eebb6977..76b68cf5 100644
--- a/styleguide/a-z-word-list-term-collections/t/tile-live-tile.md
+++ b/styleguide/a-z-word-list-term-collections/t/tile-live-tile.md
@@ -1,5 +1,6 @@
---
title: tile, Live Tile - Microsoft Style Guide
+description: Describes how to implement the terms 'tile' and 'Live Tile' in Microsoft content and clarifies to capitalize 'Live Tile'.
author: pallep
ms.author: pallep
ms.date: 07/31/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/time-out.md b/styleguide/a-z-word-list-term-collections/t/time-out.md
index 6ecfb8f8..e2e2ad76 100644
--- a/styleguide/a-z-word-list-term-collections/t/time-out.md
+++ b/styleguide/a-z-word-list-term-collections/t/time-out.md
@@ -1,5 +1,6 @@
---
title: time out, time-out - Microsoft Style Guide
+description: Describes how to implement the terms 'time out' and 'time-out' in Microsoft content and clarifies to always hyphenate this term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/time-stamp.md b/styleguide/a-z-word-list-term-collections/t/time-stamp.md
index 3623bcf2..85d6ae69 100644
--- a/styleguide/a-z-word-list-term-collections/t/time-stamp.md
+++ b/styleguide/a-z-word-list-term-collections/t/time-stamp.md
@@ -1,5 +1,6 @@
---
title: time stamp - Microsoft Style Guide
+description: Describes how to implement the term 'time stamp' in Microsoft content and clarifies to use the term as two separate words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/to-do.md b/styleguide/a-z-word-list-term-collections/t/to-do.md
index b701e034..d006609a 100644
--- a/styleguide/a-z-word-list-term-collections/t/to-do.md
+++ b/styleguide/a-z-word-list-term-collections/t/to-do.md
@@ -1,5 +1,6 @@
---
title: to-do - Microsoft Style Guide
+description: Describes how to implement the term 'to-do' in Microsoft content and provides examples of how to use this term in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/toast.md b/styleguide/a-z-word-list-term-collections/t/toast.md
index 50b99c19..7097ff61 100644
--- a/styleguide/a-z-word-list-term-collections/t/toast.md
+++ b/styleguide/a-z-word-list-term-collections/t/toast.md
@@ -1,5 +1,6 @@
---
title: toast - Microsoft Style Guide
+description: Describes how to implement the term 'toast' in Microsoft content and clarifies to use the term 'notification' in place of using the term 'toast'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/toggle.md b/styleguide/a-z-word-list-term-collections/t/toggle.md
index 87830fa4..248d45c5 100644
--- a/styleguide/a-z-word-list-term-collections/t/toggle.md
+++ b/styleguide/a-z-word-list-term-collections/t/toggle.md
@@ -1,5 +1,6 @@
---
title: toggle - Microsoft Style Guide
+description: Describes how to use the term 'toggle' in Microsoft content and provides examples of using this term in content.
author: pallep
ms.author: pallep
ms.date: 9/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/t/tone.md b/styleguide/a-z-word-list-term-collections/t/tone.md
index e66b1999..ccec6489 100644
--- a/styleguide/a-z-word-list-term-collections/t/tone.md
+++ b/styleguide/a-z-word-list-term-collections/t/tone.md
@@ -1,5 +1,6 @@
---
title: tone - Microsoft Style Guide
+description: Describes how to implement the term 'tone' in Microsoft content' and clarifies to refrain from using it as a beeping sound.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/tool.md b/styleguide/a-z-word-list-term-collections/t/tool.md
index 59c5d180..fdff8d12 100644
--- a/styleguide/a-z-word-list-term-collections/t/tool.md
+++ b/styleguide/a-z-word-list-term-collections/t/tool.md
@@ -1,5 +1,6 @@
---
title: tool - Microsoft Style Guide
+description: Describes how to implement the term 'tool' in Microsoft content and provides topics that provide similar terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/toolkit.md b/styleguide/a-z-word-list-term-collections/t/toolkit.md
index 533e1fa0..a428b3f1 100644
--- a/styleguide/a-z-word-list-term-collections/t/toolkit.md
+++ b/styleguide/a-z-word-list-term-collections/t/toolkit.md
@@ -1,5 +1,6 @@
---
title: toolkit - Microsoft Style Guide
+description: Describes how to implement the term 'toolkit' in Microsoft content and clarifies that the term is to be written as one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/top-left-top-right.md b/styleguide/a-z-word-list-term-collections/t/top-left-top-right.md
index bc8c6c1b..11a2dc7a 100644
--- a/styleguide/a-z-word-list-term-collections/t/top-left-top-right.md
+++ b/styleguide/a-z-word-list-term-collections/t/top-left-top-right.md
@@ -1,5 +1,6 @@
---
title: top left, top right - Microsoft Style Guide
+description: Describes that the 'top left' and 'top right' terms are not to be used in Microsoft content and provides links to the upper left and upper right topics.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/top-level-folder.md b/styleguide/a-z-word-list-term-collections/t/top-level-folder.md
index 06d87144..86b29a1d 100644
--- a/styleguide/a-z-word-list-term-collections/t/top-level-folder.md
+++ b/styleguide/a-z-word-list-term-collections/t/top-level-folder.md
@@ -1,5 +1,6 @@
---
title: top-level folder - Microsoft Style Guide
+description: Describes how to use the term 'top-level folder' in Microsoft content and provides an example of using this term in content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md b/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
index e269cca8..264437db 100644
--- a/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
+++ b/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md
@@ -1,5 +1,6 @@
---
title: touch-sensitive - Microsoft Style Guide
+description: Describes how to implement the term 'touch-sensitive' in Microsoft content and clarifies that this term is to always be hyphenated.
author: pallep
ms.author: pallep
ms.date: 08/25/2021
diff --git a/styleguide/a-z-word-list-term-collections/t/touchpad.md b/styleguide/a-z-word-list-term-collections/t/touchpad.md
index 88a0bfd7..54df34b7 100644
--- a/styleguide/a-z-word-list-term-collections/t/touchpad.md
+++ b/styleguide/a-z-word-list-term-collections/t/touchpad.md
@@ -1,5 +1,6 @@
---
title: touchpad - Microsoft Style Guide
+description: In place of describing how to use the term 'touchpad' in Microsoft content, this article provides a link to the Computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/touchscreen.md b/styleguide/a-z-word-list-term-collections/t/touchscreen.md
index 91143003..ee5cff5d 100644
--- a/styleguide/a-z-word-list-term-collections/t/touchscreen.md
+++ b/styleguide/a-z-word-list-term-collections/t/touchscreen.md
@@ -1,5 +1,6 @@
---
title: touchscreen - Microsoft Style Guide
+description: In place of describing how to use the term 'touchscreen' in Microsoft content, this article provides a link to the Computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/toward.md b/styleguide/a-z-word-list-term-collections/t/toward.md
index 9266d14c..a3543ea2 100644
--- a/styleguide/a-z-word-list-term-collections/t/toward.md
+++ b/styleguide/a-z-word-list-term-collections/t/toward.md
@@ -1,5 +1,6 @@
---
title: toward - Microsoft Style Guide
+description: Describes to implement the term 'toward' in Microsoft content and clarifies to use 'toward' in place of 'towards'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/trackball.md b/styleguide/a-z-word-list-term-collections/t/trackball.md
index 4e62b51e..b3e81e64 100644
--- a/styleguide/a-z-word-list-term-collections/t/trackball.md
+++ b/styleguide/a-z-word-list-term-collections/t/trackball.md
@@ -1,5 +1,6 @@
---
title: trackball - Microsoft Style Guide
+description: In place of describing how to use the term 'trackball' in Microsoft content, this article provides a link to the Computer and device term collection topic.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/t/trailing.md b/styleguide/a-z-word-list-term-collections/t/trailing.md
index f283d0cc..9a69f872 100644
--- a/styleguide/a-z-word-list-term-collections/t/trailing.md
+++ b/styleguide/a-z-word-list-term-collections/t/trailing.md
@@ -1,5 +1,6 @@
---
title: trailing - Microsoft Style Guide
+description: Describes how to implement the term 'trailing' in Microsoft content and clarifies that this term is to be used instead of 'following' in certain instances.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/trojan-horse-trojan.md b/styleguide/a-z-word-list-term-collections/t/trojan-horse-trojan.md
index 24faf511..3de97b65 100644
--- a/styleguide/a-z-word-list-term-collections/t/trojan-horse-trojan.md
+++ b/styleguide/a-z-word-list-term-collections/t/trojan-horse-trojan.md
@@ -1,5 +1,6 @@
---
title: trojan horse, trojan - Microsoft Style Guide
+description: In place of describing how to use the term 'trojan horse' in Microsoft content, this article provides a link to the security term collection topic.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/t/turnkey.md b/styleguide/a-z-word-list-term-collections/t/turnkey.md
index 4cc762a6..7ab9c4c2 100644
--- a/styleguide/a-z-word-list-term-collections/t/turnkey.md
+++ b/styleguide/a-z-word-list-term-collections/t/turnkey.md
@@ -1,5 +1,6 @@
---
title: turnkey - Microsoft Style Guide
+description: Describes how to implement the term 'turnkey' in Microsoft content and clarifies that the term is to be written as one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 237ecbdd793212e3880f61780c254192740daaf6 Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 16:23:17 -0700
Subject: [PATCH 208/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/m/machine-learning.md | 1 +
styleguide/a-z-word-list-term-collections/m/machine.md | 1 +
styleguide/a-z-word-list-term-collections/m/main-document.md | 1 +
styleguide/a-z-word-list-term-collections/m/makefile.md | 1 +
styleguide/a-z-word-list-term-collections/m/malicious-code.md | 1 +
styleguide/a-z-word-list-term-collections/m/malicious-user.md | 1 +
.../m/malware-malicious-software.md | 1 +
.../m/management-information-systems.md | 1 +
styleguide/a-z-word-list-term-collections/m/manipulate.md | 1 +
styleguide/a-z-word-list-term-collections/m/marquee.md | 1 +
styleguide/a-z-word-list-term-collections/m/mathematical.md | 1 +
styleguide/a-z-word-list-term-collections/m/matrix-matrices.md | 1 +
styleguide/a-z-word-list-term-collections/m/medium-media.md | 1 +
styleguide/a-z-word-list-term-collections/m/megabit.md | 1 +
.../a-z-word-list-term-collections/m/megabits-per-second.md | 1 +
styleguide/a-z-word-list-term-collections/m/megabyte.md | 1 +
styleguide/a-z-word-list-term-collections/m/megahertz.md | 1 +
styleguide/a-z-word-list-term-collections/m/member-function.md | 1 +
styleguide/a-z-word-list-term-collections/m/memory-resident.md | 1 +
styleguide/a-z-word-list-term-collections/m/memory.md | 1 +
styleguide/a-z-word-list-term-collections/m/menu-item.md | 1 +
styleguide/a-z-word-list-term-collections/m/message.md | 1 +
styleguide/a-z-word-list-term-collections/m/metafile.md | 1 +
styleguide/a-z-word-list-term-collections/m/micro.md | 1 +
styleguide/a-z-word-list-term-collections/m/microprocessor.md | 1 +
styleguide/a-z-word-list-term-collections/m/microsoft-account.md | 1 +
styleguide/a-z-word-list-term-collections/m/microsoft-ai.md | 1 +
styleguide/a-z-word-list-term-collections/m/microsoft-store.md | 1 +
styleguide/a-z-word-list-term-collections/m/microsoft.md | 1 +
styleguide/a-z-word-list-term-collections/m/midnight.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/m/machine-learning.md b/styleguide/a-z-word-list-term-collections/m/machine-learning.md
index 3830cd78..c7973427 100644
--- a/styleguide/a-z-word-list-term-collections/m/machine-learning.md
+++ b/styleguide/a-z-word-list-term-collections/m/machine-learning.md
@@ -1,5 +1,6 @@
---
title: machine learning - Microsoft Style Guide
+description: Describes guidelines to use 'machine learning' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/machine.md b/styleguide/a-z-word-list-term-collections/m/machine.md
index 04feaabd..5e315793 100644
--- a/styleguide/a-z-word-list-term-collections/m/machine.md
+++ b/styleguide/a-z-word-list-term-collections/m/machine.md
@@ -1,5 +1,6 @@
---
title: machine - Microsoft Style Guide
+description: To learn more about using 'machine' in Microsoft documents, see 'Computer and device term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/main-document.md b/styleguide/a-z-word-list-term-collections/m/main-document.md
index 70a160a8..6d4495c6 100644
--- a/styleguide/a-z-word-list-term-collections/m/main-document.md
+++ b/styleguide/a-z-word-list-term-collections/m/main-document.md
@@ -1,5 +1,6 @@
---
title: main document - Microsoft Style Guide
+description: Describes guidelines to use 'main document' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/makefile.md b/styleguide/a-z-word-list-term-collections/m/makefile.md
index 49343970..2ceeeda7 100644
--- a/styleguide/a-z-word-list-term-collections/m/makefile.md
+++ b/styleguide/a-z-word-list-term-collections/m/makefile.md
@@ -1,5 +1,6 @@
---
title: makefile - Microsoft Style Guide
+description: Describes guidelines to use 'makefile' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/malicious-code.md b/styleguide/a-z-word-list-term-collections/m/malicious-code.md
index dfcbb876..a2179ce7 100644
--- a/styleguide/a-z-word-list-term-collections/m/malicious-code.md
+++ b/styleguide/a-z-word-list-term-collections/m/malicious-code.md
@@ -1,5 +1,6 @@
---
title: malicious code - Microsoft Style Guide
+description: To learn more about using 'malicious code' in Microsoft documents, see 'Security term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/malicious-user.md b/styleguide/a-z-word-list-term-collections/m/malicious-user.md
index f72c2615..b331add0 100644
--- a/styleguide/a-z-word-list-term-collections/m/malicious-user.md
+++ b/styleguide/a-z-word-list-term-collections/m/malicious-user.md
@@ -1,5 +1,6 @@
---
title: malicious user - Microsoft Style Guide
+description: To learn more about using 'malicious user' in Microsoft documents, see 'Security term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/malware-malicious-software.md b/styleguide/a-z-word-list-term-collections/m/malware-malicious-software.md
index 3d62c3a2..69fc6af0 100644
--- a/styleguide/a-z-word-list-term-collections/m/malware-malicious-software.md
+++ b/styleguide/a-z-word-list-term-collections/m/malware-malicious-software.md
@@ -1,5 +1,6 @@
---
title: malware, malicious software - Microsoft Style Guide
+description: To learn more about using 'malware' or 'malicious software' in Microsoft documents, see 'Security term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/management-information-systems.md b/styleguide/a-z-word-list-term-collections/m/management-information-systems.md
index c96151b7..19b9d10f 100644
--- a/styleguide/a-z-word-list-term-collections/m/management-information-systems.md
+++ b/styleguide/a-z-word-list-term-collections/m/management-information-systems.md
@@ -1,5 +1,6 @@
---
title: management information systems - Microsoft Style Guide
+description: Describes guidelines to use 'management information systems' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/manipulate.md b/styleguide/a-z-word-list-term-collections/m/manipulate.md
index e24ad5e9..1c4379f7 100644
--- a/styleguide/a-z-word-list-term-collections/m/manipulate.md
+++ b/styleguide/a-z-word-list-term-collections/m/manipulate.md
@@ -1,5 +1,6 @@
---
title: manipulate - Microsoft Style Guide
+description: Describes guidelines to use 'manipulate' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/marquee.md b/styleguide/a-z-word-list-term-collections/m/marquee.md
index b658c74a..f4dad169 100644
--- a/styleguide/a-z-word-list-term-collections/m/marquee.md
+++ b/styleguide/a-z-word-list-term-collections/m/marquee.md
@@ -1,5 +1,6 @@
---
title: marquee - Microsoft Style Guide
+description: Describes guidelines to use 'marquee' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mathematical.md b/styleguide/a-z-word-list-term-collections/m/mathematical.md
index ab5cd37b..99bc3d18 100644
--- a/styleguide/a-z-word-list-term-collections/m/mathematical.md
+++ b/styleguide/a-z-word-list-term-collections/m/mathematical.md
@@ -1,5 +1,6 @@
---
title: mathematical - Microsoft Style Guide
+description: In Microsoft documents, use 'mathematical' instead of 'mathematic'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/matrix-matrices.md b/styleguide/a-z-word-list-term-collections/m/matrix-matrices.md
index 73d80dd2..c935cd6a 100644
--- a/styleguide/a-z-word-list-term-collections/m/matrix-matrices.md
+++ b/styleguide/a-z-word-list-term-collections/m/matrix-matrices.md
@@ -1,5 +1,6 @@
---
title: matrix, matrices - Microsoft Style Guide
+description: Describes guidelines to use 'matrices' as the plural form of 'matrix' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/medium-media.md b/styleguide/a-z-word-list-term-collections/m/medium-media.md
index 623f2b93..3736d03f 100644
--- a/styleguide/a-z-word-list-term-collections/m/medium-media.md
+++ b/styleguide/a-z-word-list-term-collections/m/medium-media.md
@@ -1,5 +1,6 @@
---
title: medium, media - Microsoft Style Guide
+description: Describes guidelines to use 'medium' or 'media' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/megabit.md b/styleguide/a-z-word-list-term-collections/m/megabit.md
index d40777ff..2566793a 100644
--- a/styleguide/a-z-word-list-term-collections/m/megabit.md
+++ b/styleguide/a-z-word-list-term-collections/m/megabit.md
@@ -1,5 +1,6 @@
---
title: megabit, Mb, Mbit - Microsoft Style Guide
+description: To learn more about using 'megabit', 'Mb', or 'Mbit' in Microsoft documents, see 'Bits and bytes term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/megabits-per-second.md b/styleguide/a-z-word-list-term-collections/m/megabits-per-second.md
index 8ca5d149..cbb66d93 100644
--- a/styleguide/a-z-word-list-term-collections/m/megabits-per-second.md
+++ b/styleguide/a-z-word-list-term-collections/m/megabits-per-second.md
@@ -1,5 +1,6 @@
---
title: megabits per second, Mbps - Microsoft Style Guide
+description: To learn more about using 'megabits per second' or 'Mbps' in Microsoft documents, see 'Bits and bytes term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/megabyte.md b/styleguide/a-z-word-list-term-collections/m/megabyte.md
index e260242c..1231850a 100644
--- a/styleguide/a-z-word-list-term-collections/m/megabyte.md
+++ b/styleguide/a-z-word-list-term-collections/m/megabyte.md
@@ -1,5 +1,6 @@
---
title: megabyte, MB, meg, M, M byte, Mbyte - Microsoft Style Guide
+description: To learn more about using 'megabyte', 'MB', 'meg', 'M', 'M byte', and 'Mbyte' in Microsoft documents, see 'Bits and bytes term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/megahertz.md b/styleguide/a-z-word-list-term-collections/m/megahertz.md
index a0378cc2..27968ccb 100644
--- a/styleguide/a-z-word-list-term-collections/m/megahertz.md
+++ b/styleguide/a-z-word-list-term-collections/m/megahertz.md
@@ -1,5 +1,6 @@
---
title: megahertz, MHz - Microsoft Style Guide
+description: To learn more about using 'megahertz' or 'MHz' in Microsoft documents, see 'Units of measure term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/member-function.md b/styleguide/a-z-word-list-term-collections/m/member-function.md
index 7e309210..e93af10a 100644
--- a/styleguide/a-z-word-list-term-collections/m/member-function.md
+++ b/styleguide/a-z-word-list-term-collections/m/member-function.md
@@ -1,5 +1,6 @@
---
title: member function - Microsoft Style Guide
+description: Describes guidelines to use 'member function' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/memory-resident.md b/styleguide/a-z-word-list-term-collections/m/memory-resident.md
index 55827cad..02212bf4 100644
--- a/styleguide/a-z-word-list-term-collections/m/memory-resident.md
+++ b/styleguide/a-z-word-list-term-collections/m/memory-resident.md
@@ -1,5 +1,6 @@
---
title: memory-resident - Microsoft Style Guide
+description: Describes guidelines to use 'memory-resident' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/memory.md b/styleguide/a-z-word-list-term-collections/m/memory.md
index 5c27a937..43b54eb1 100644
--- a/styleguide/a-z-word-list-term-collections/m/memory.md
+++ b/styleguide/a-z-word-list-term-collections/m/memory.md
@@ -1,5 +1,6 @@
---
title: memory - Microsoft Style Guide
+description: Describes guidelines to use 'memory' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/menu-item.md b/styleguide/a-z-word-list-term-collections/m/menu-item.md
index 09658143..502b56f9 100644
--- a/styleguide/a-z-word-list-term-collections/m/menu-item.md
+++ b/styleguide/a-z-word-list-term-collections/m/menu-item.md
@@ -1,5 +1,6 @@
---
title: menu item - Microsoft Style Guide
+description: Describes guidelines to use 'menu item' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/message.md b/styleguide/a-z-word-list-term-collections/m/message.md
index 0c6946de..fd9f55bf 100644
--- a/styleguide/a-z-word-list-term-collections/m/message.md
+++ b/styleguide/a-z-word-list-term-collections/m/message.md
@@ -1,5 +1,6 @@
---
title: message - Microsoft Style Guide
+description: Describes guidelines to use 'message' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/metafile.md b/styleguide/a-z-word-list-term-collections/m/metafile.md
index 3a81f9e0..1f80a8de 100644
--- a/styleguide/a-z-word-list-term-collections/m/metafile.md
+++ b/styleguide/a-z-word-list-term-collections/m/metafile.md
@@ -1,5 +1,6 @@
---
title: metafile - Microsoft Style Guide
+description: When using 'metafile' in Microsoft documents, always write it as one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/micro.md b/styleguide/a-z-word-list-term-collections/m/micro.md
index 8308f58d..2bd7ba68 100644
--- a/styleguide/a-z-word-list-term-collections/m/micro.md
+++ b/styleguide/a-z-word-list-term-collections/m/micro.md
@@ -1,5 +1,6 @@
---
title: micro- - Microsoft Style Guide
+description: Describes guidelines to use 'micro-' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/microprocessor.md b/styleguide/a-z-word-list-term-collections/m/microprocessor.md
index b1925930..b6e3bfb1 100644
--- a/styleguide/a-z-word-list-term-collections/m/microprocessor.md
+++ b/styleguide/a-z-word-list-term-collections/m/microprocessor.md
@@ -1,5 +1,6 @@
---
title: microprocessor - Microsoft Style Guide
+description: Describes guidelines to use 'microprocessor' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/microsoft-account.md b/styleguide/a-z-word-list-term-collections/m/microsoft-account.md
index e1752eef..f34dad59 100644
--- a/styleguide/a-z-word-list-term-collections/m/microsoft-account.md
+++ b/styleguide/a-z-word-list-term-collections/m/microsoft-account.md
@@ -1,5 +1,6 @@
---
title: Microsoft account - Microsoft Style Guide
+description: Describes guidelines to use 'Microsoft account' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 07/31/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/microsoft-ai.md b/styleguide/a-z-word-list-term-collections/m/microsoft-ai.md
index 0bc44d93..d39ca549 100644
--- a/styleguide/a-z-word-list-term-collections/m/microsoft-ai.md
+++ b/styleguide/a-z-word-list-term-collections/m/microsoft-ai.md
@@ -1,5 +1,6 @@
---
title: Microsoft AI - Microsoft Style Guide
+description: To learn more about using 'Microsoft AI' in Microsoft documents, see 'AI and bot term collection.'
author: pallep
ms.author: pallep
ms.date: 02/21/2019
diff --git a/styleguide/a-z-word-list-term-collections/m/microsoft-store.md b/styleguide/a-z-word-list-term-collections/m/microsoft-store.md
index 8d985012..abd3f0ef 100644
--- a/styleguide/a-z-word-list-term-collections/m/microsoft-store.md
+++ b/styleguide/a-z-word-list-term-collections/m/microsoft-store.md
@@ -1,5 +1,6 @@
---
title: Microsoft Store - Microsoft Style Guide
+description: Describes guidelines to use 'Microsoft Store' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 3/15/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/microsoft.md b/styleguide/a-z-word-list-term-collections/m/microsoft.md
index ee011db1..d2fad361 100644
--- a/styleguide/a-z-word-list-term-collections/m/microsoft.md
+++ b/styleguide/a-z-word-list-term-collections/m/microsoft.md
@@ -1,5 +1,6 @@
---
title: Microsoft - Microsoft Style Guide
+description: Describes guidelines to use 'Microsoft' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 09/17/2019
diff --git a/styleguide/a-z-word-list-term-collections/m/midnight.md b/styleguide/a-z-word-list-term-collections/m/midnight.md
index 69deed52..9089284d 100644
--- a/styleguide/a-z-word-list-term-collections/m/midnight.md
+++ b/styleguide/a-z-word-list-term-collections/m/midnight.md
@@ -1,5 +1,6 @@
---
title: midnight - Microsoft Style Guide
+description: To learn more about using 'midnight' in Microsoft documents, see 'Date and time term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From d6fa9dc795043bbb52fc8a9819b7842cdaf503e6 Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 17:02:35 -0700
Subject: [PATCH 209/486] Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/m/million-m.md | 1 +
styleguide/a-z-word-list-term-collections/m/minus-sign.md | 1 +
styleguide/a-z-word-list-term-collections/m/mip-mapping.md | 1 +
styleguide/a-z-word-list-term-collections/m/mission-critical.md | 1 +
styleguide/a-z-word-list-term-collections/m/mixed-reality.md | 1 +
.../m/mobile-device-mobile-phone.md | 1 +
styleguide/a-z-word-list-term-collections/m/monitor.md | 1 +
styleguide/a-z-word-list-term-collections/m/monospace.md | 1 +
styleguide/a-z-word-list-term-collections/m/more-than-vs-over.md | 1 +
styleguide/a-z-word-list-term-collections/m/mouse-over.md | 1 +
styleguide/a-z-word-list-term-collections/m/mouse.md | 1 +
styleguide/a-z-word-list-term-collections/m/movable.md | 1 +
styleguide/a-z-word-list-term-collections/m/move.md | 1 +
styleguide/a-z-word-list-term-collections/m/mpeg.md | 1 +
styleguide/a-z-word-list-term-collections/m/multi.md | 1 +
.../a-z-word-list-term-collections/m/multiple-selection.md | 1 +
.../a-z-word-list-term-collections/m/multiplication-sign.md | 1 +
.../a-z-word-list-term-collections/m/multitask-multitasking.md | 1 +
styleguide/a-z-word-list-term-collections/m/multithreaded.md | 1 +
.../a-z-word-list-term-collections/m/software-license-terms.md | 1 +
styleguide/a-z-word-list-term-collections/n/n.md | 1 +
styleguide/a-z-word-list-term-collections/n/namespace.md | 1 +
styleguide/a-z-word-list-term-collections/n/nanosecond.md | 1 +
styleguide/a-z-word-list-term-collections/n/native-language.md | 1 +
.../n/natural-user-interface-nui.md | 1 +
styleguide/a-z-word-list-term-collections/n/navigate.md | 1 +
styleguide/a-z-word-list-term-collections/n/need.md | 1 +
styleguide/a-z-word-list-term-collections/n/net.md | 1 +
styleguide/a-z-word-list-term-collections/n/network-adapter.md | 1 +
styleguide/a-z-word-list-term-collections/n/network.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/m/million-m.md b/styleguide/a-z-word-list-term-collections/m/million-m.md
index 88dbf246..fe44a6cd 100644
--- a/styleguide/a-z-word-list-term-collections/m/million-m.md
+++ b/styleguide/a-z-word-list-term-collections/m/million-m.md
@@ -1,5 +1,6 @@
---
title: million, M - Microsoft Style Guide
+description: To learn more about using 'million' or 'M' in Microsoft documents, see 'Numbers.'
author: pallep
ms.author: pallep
ms.date: 09/18/2019
diff --git a/styleguide/a-z-word-list-term-collections/m/minus-sign.md b/styleguide/a-z-word-list-term-collections/m/minus-sign.md
index b254d452..8e588ce9 100644
--- a/styleguide/a-z-word-list-term-collections/m/minus-sign.md
+++ b/styleguide/a-z-word-list-term-collections/m/minus-sign.md
@@ -1,5 +1,6 @@
---
title: minus sign (–) - Microsoft Style Guide
+description: Describes guidelines to use the minus sign (-) in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mip-mapping.md b/styleguide/a-z-word-list-term-collections/m/mip-mapping.md
index bddec443..ec5b789d 100644
--- a/styleguide/a-z-word-list-term-collections/m/mip-mapping.md
+++ b/styleguide/a-z-word-list-term-collections/m/mip-mapping.md
@@ -1,5 +1,6 @@
---
title: MIP mapping - Microsoft Style Guide
+description: Describes guidelines to use 'MIP mapping' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mission-critical.md b/styleguide/a-z-word-list-term-collections/m/mission-critical.md
index 9c235f8f..7ef2981a 100644
--- a/styleguide/a-z-word-list-term-collections/m/mission-critical.md
+++ b/styleguide/a-z-word-list-term-collections/m/mission-critical.md
@@ -1,5 +1,6 @@
---
title: mission critical, mission-critical - Microsoft Style Guide
+description: Describes guidelines to use 'mission critical' and 'mission-critical' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mixed-reality.md b/styleguide/a-z-word-list-term-collections/m/mixed-reality.md
index cf776ee8..68308bbd 100644
--- a/styleguide/a-z-word-list-term-collections/m/mixed-reality.md
+++ b/styleguide/a-z-word-list-term-collections/m/mixed-reality.md
@@ -1,5 +1,6 @@
---
title: mixed reality, mixed-reality - Microsoft Style Guide
+description: Describes guidelines to use 'mixed reality' or 'mixed-reality' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 04/1/2019
diff --git a/styleguide/a-z-word-list-term-collections/m/mobile-device-mobile-phone.md b/styleguide/a-z-word-list-term-collections/m/mobile-device-mobile-phone.md
index 13a18088..71358cfa 100644
--- a/styleguide/a-z-word-list-term-collections/m/mobile-device-mobile-phone.md
+++ b/styleguide/a-z-word-list-term-collections/m/mobile-device-mobile-phone.md
@@ -1,5 +1,6 @@
---
title: mobile device, mobile phone - Microsoft Style Guide
+description: To learn more about using 'mobile device' and 'mobile phone' in Microsoft documents, see 'Computer and device term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/monitor.md b/styleguide/a-z-word-list-term-collections/m/monitor.md
index 2713cd08..efbe2a9e 100644
--- a/styleguide/a-z-word-list-term-collections/m/monitor.md
+++ b/styleguide/a-z-word-list-term-collections/m/monitor.md
@@ -1,5 +1,6 @@
---
title: monitor - Microsoft Style Guide
+description: To learn more about using 'monitor' in Microsoft documents, see 'Computer and device term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/monospace.md b/styleguide/a-z-word-list-term-collections/m/monospace.md
index f87b3666..5a291380 100644
--- a/styleguide/a-z-word-list-term-collections/m/monospace.md
+++ b/styleguide/a-z-word-list-term-collections/m/monospace.md
@@ -1,5 +1,6 @@
---
title: monospace - Microsoft Style Guide
+description: Describes guidelines to use 'monospace' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/more-than-vs-over.md b/styleguide/a-z-word-list-term-collections/m/more-than-vs-over.md
index 9ba9f40e..49eec39e 100644
--- a/styleguide/a-z-word-list-term-collections/m/more-than-vs-over.md
+++ b/styleguide/a-z-word-list-term-collections/m/more-than-vs-over.md
@@ -1,5 +1,6 @@
---
title: more than vs. over - Microsoft Style Guide
+description: Describes guidelines to use 'more than' versus 'over' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mouse-over.md b/styleguide/a-z-word-list-term-collections/m/mouse-over.md
index 7a96cee7..08e63884 100644
--- a/styleguide/a-z-word-list-term-collections/m/mouse-over.md
+++ b/styleguide/a-z-word-list-term-collections/m/mouse-over.md
@@ -1,5 +1,6 @@
---
title: mouse over - Microsoft Style Guide
+description: To learn more about using 'mouse over' in Microsoft documents, see 'Mouse and mouse interaction terms.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mouse.md b/styleguide/a-z-word-list-term-collections/m/mouse.md
index 30aeeef6..8b36c804 100644
--- a/styleguide/a-z-word-list-term-collections/m/mouse.md
+++ b/styleguide/a-z-word-list-term-collections/m/mouse.md
@@ -1,5 +1,6 @@
---
title: mouse - Microsoft Style Guide
+description: To learn more about using 'mouse' in Microsoft documents, see 'Computer and device term collection' and 'Mouse and mouse interaction term collection.'
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/m/movable.md b/styleguide/a-z-word-list-term-collections/m/movable.md
index 248013b5..a2ed2872 100644
--- a/styleguide/a-z-word-list-term-collections/m/movable.md
+++ b/styleguide/a-z-word-list-term-collections/m/movable.md
@@ -1,5 +1,6 @@
---
title: movable - Microsoft Style Guide
+description: Describes guidelines to use 'movable' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/move.md b/styleguide/a-z-word-list-term-collections/m/move.md
index 0a59e3fa..a14b609f 100644
--- a/styleguide/a-z-word-list-term-collections/m/move.md
+++ b/styleguide/a-z-word-list-term-collections/m/move.md
@@ -1,5 +1,6 @@
---
title: move - Microsoft Style Guide
+description: Describes guidelines to use 'move' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/mpeg.md b/styleguide/a-z-word-list-term-collections/m/mpeg.md
index 24359723..a244a4c9 100644
--- a/styleguide/a-z-word-list-term-collections/m/mpeg.md
+++ b/styleguide/a-z-word-list-term-collections/m/mpeg.md
@@ -1,5 +1,6 @@
---
title: MPEG - Microsoft Style Guide
+description: Describes guidelines to use 'MPEG' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/multi.md b/styleguide/a-z-word-list-term-collections/m/multi.md
index b24fb95a..48942f2b 100644
--- a/styleguide/a-z-word-list-term-collections/m/multi.md
+++ b/styleguide/a-z-word-list-term-collections/m/multi.md
@@ -1,5 +1,6 @@
---
title: multi- - Microsoft Style Guide
+description: Describes guidelines to use the suffix 'multi-' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 08/26/2021
diff --git a/styleguide/a-z-word-list-term-collections/m/multiple-selection.md b/styleguide/a-z-word-list-term-collections/m/multiple-selection.md
index a2054ca6..e7660a8f 100644
--- a/styleguide/a-z-word-list-term-collections/m/multiple-selection.md
+++ b/styleguide/a-z-word-list-term-collections/m/multiple-selection.md
@@ -1,5 +1,6 @@
---
title: multiple selection - Microsoft Style Guide
+description: Describes guidelines to use 'multiple selection' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/multiplication-sign.md b/styleguide/a-z-word-list-term-collections/m/multiplication-sign.md
index bc07dcc2..64c8b044 100644
--- a/styleguide/a-z-word-list-term-collections/m/multiplication-sign.md
+++ b/styleguide/a-z-word-list-term-collections/m/multiplication-sign.md
@@ -1,5 +1,6 @@
---
title: multiplication sign (×) - Microsoft Style Guide
+description: Describes guidelines to use a multiplication sign (×) in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/multitask-multitasking.md b/styleguide/a-z-word-list-term-collections/m/multitask-multitasking.md
index 18b4e775..9b2d2f8f 100644
--- a/styleguide/a-z-word-list-term-collections/m/multitask-multitasking.md
+++ b/styleguide/a-z-word-list-term-collections/m/multitask-multitasking.md
@@ -1,5 +1,6 @@
---
title: multitask, multitasking - Microsoft Style Guide
+description: Describes guidelines to use 'multitask' and 'multitasking' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/multithreaded.md b/styleguide/a-z-word-list-term-collections/m/multithreaded.md
index c4ee0272..9901675f 100644
--- a/styleguide/a-z-word-list-term-collections/m/multithreaded.md
+++ b/styleguide/a-z-word-list-term-collections/m/multithreaded.md
@@ -1,5 +1,6 @@
---
title: multithreaded - Microsoft Style Guide
+description: Describes guidelines to use 'multithreaded' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/m/software-license-terms.md b/styleguide/a-z-word-list-term-collections/m/software-license-terms.md
index 199985f3..47e18232 100644
--- a/styleguide/a-z-word-list-term-collections/m/software-license-terms.md
+++ b/styleguide/a-z-word-list-term-collections/m/software-license-terms.md
@@ -1,5 +1,6 @@
---
title: Microsoft Software License Terms - Microsoft Style Guide
+description: Describes guidelines to use 'Microsoft Software License Terms' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/n.md b/styleguide/a-z-word-list-term-collections/n/n.md
index 3b37beed..5b2398cd 100644
--- a/styleguide/a-z-word-list-term-collections/n/n.md
+++ b/styleguide/a-z-word-list-term-collections/n/n.md
@@ -1,5 +1,6 @@
---
title: n - Microsoft Style Guide
+description: Describes guidelines to use 'n' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/namespace.md b/styleguide/a-z-word-list-term-collections/n/namespace.md
index 9123868e..4e5371a2 100644
--- a/styleguide/a-z-word-list-term-collections/n/namespace.md
+++ b/styleguide/a-z-word-list-term-collections/n/namespace.md
@@ -1,5 +1,6 @@
---
title: namespace - Microsoft Style Guide
+description: When using 'namespace' in Microsoft documents, write it as a single word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/nanosecond.md b/styleguide/a-z-word-list-term-collections/n/nanosecond.md
index f902f1eb..741b2540 100644
--- a/styleguide/a-z-word-list-term-collections/n/nanosecond.md
+++ b/styleguide/a-z-word-list-term-collections/n/nanosecond.md
@@ -1,5 +1,6 @@
---
title: nanosecond - Microsoft Style Guide
+description: To learn more about using 'nanosecond' in Microsoft documents, see 'Date and time term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/native-language.md b/styleguide/a-z-word-list-term-collections/n/native-language.md
index 4dfb4a61..148f55d0 100644
--- a/styleguide/a-z-word-list-term-collections/n/native-language.md
+++ b/styleguide/a-z-word-list-term-collections/n/native-language.md
@@ -1,5 +1,6 @@
---
title: native language - Microsoft Style Guide
+description: Describes guidelines to use 'native language' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/natural-user-interface-nui.md b/styleguide/a-z-word-list-term-collections/n/natural-user-interface-nui.md
index a60a0e78..ca6620f5 100644
--- a/styleguide/a-z-word-list-term-collections/n/natural-user-interface-nui.md
+++ b/styleguide/a-z-word-list-term-collections/n/natural-user-interface-nui.md
@@ -1,5 +1,6 @@
---
title: natural user interface, NUI - Microsoft Style Guide
+description: Describes guidelines to use 'natural user interface' or 'NUI' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/navigate.md b/styleguide/a-z-word-list-term-collections/n/navigate.md
index 7ed8a3d5..284cfb25 100644
--- a/styleguide/a-z-word-list-term-collections/n/navigate.md
+++ b/styleguide/a-z-word-list-term-collections/n/navigate.md
@@ -1,5 +1,6 @@
---
title: navigate - Microsoft Style Guide
+description: Describes guidelines to use 'navigate' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/need.md b/styleguide/a-z-word-list-term-collections/n/need.md
index 12ed0005..47836739 100644
--- a/styleguide/a-z-word-list-term-collections/n/need.md
+++ b/styleguide/a-z-word-list-term-collections/n/need.md
@@ -1,5 +1,6 @@
---
title: need - Microsoft Style Guide
+description: Describes guidelines to use 'need' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/net.md b/styleguide/a-z-word-list-term-collections/n/net.md
index 29e1b944..b6f28f9f 100644
--- a/styleguide/a-z-word-list-term-collections/n/net.md
+++ b/styleguide/a-z-word-list-term-collections/n/net.md
@@ -1,5 +1,6 @@
---
title: .NET - Microsoft Style Guide
+description: Describes guidelines to use '.NET' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/network-adapter.md b/styleguide/a-z-word-list-term-collections/n/network-adapter.md
index 1fdb4484..d470d062 100644
--- a/styleguide/a-z-word-list-term-collections/n/network-adapter.md
+++ b/styleguide/a-z-word-list-term-collections/n/network-adapter.md
@@ -1,5 +1,6 @@
---
title: network adapter - Microsoft Style Guide
+description: To learn more about using 'network adapter' in Microsoft documents, see 'Computer and device term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/network.md b/styleguide/a-z-word-list-term-collections/n/network.md
index 49a28775..2b525383 100644
--- a/styleguide/a-z-word-list-term-collections/n/network.md
+++ b/styleguide/a-z-word-list-term-collections/n/network.md
@@ -1,5 +1,6 @@
---
title: network - Microsoft Style Guide
+description: Describes guidelines to use 'network' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 23edab8be970be7e1681a6aec3d96699f44d7213 Mon Sep 17 00:00:00 2001
From: LSchaufMS <101521964+LSchaufMS@users.noreply.github.com>
Date: Thu, 2 Jun 2022 19:23:34 -0700
Subject: [PATCH 210/486] Validation: add missing descriptions
---
.../a-z-word-list-term-collections/n/network-administrator.md | 1 +
.../a-z-word-list-term-collections/n/network-connection.md | 1 +
styleguide/a-z-word-list-term-collections/n/network-drive.md | 1 +
styleguide/a-z-word-list-term-collections/n/newsreader.md | 1 +
styleguide/a-z-word-list-term-collections/n/non.md | 1 +
.../a-z-word-list-term-collections/n/nonadjacent-selection.md | 1 +
.../a-z-word-list-term-collections/n/noncontiguous-selection.md | 1 +
.../a-z-word-list-term-collections/n/nonprintable-nonprinting.md | 1 +
styleguide/a-z-word-list-term-collections/n/normal-normally.md | 1 +
styleguide/a-z-word-list-term-collections/n/notification-area.md | 1 +
styleguide/a-z-word-list-term-collections/n/notification.md | 1 +
.../n/null-terminated-null-terminating.md | 1 +
styleguide/a-z-word-list-term-collections/n/null.md | 1 +
styleguide/a-z-word-list-term-collections/n/number-sign.md | 1 +
styleguide/a-z-word-list-term-collections/n/numeric.md | 1 +
.../numbers-symbols/2d-two-dimensional.md | 1 +
.../numbers-symbols/3d-three-dimensional.md | 1 +
.../numbers-symbols/85-x-11-paper.md | 1 +
.../numbers-symbols/twenty-four-seven.md | 1 +
styleguide/a-z-word-list-term-collections/o/object.md | 1 +
styleguide/a-z-word-list-term-collections/o/obsolete.md | 1 +
styleguide/a-z-word-list-term-collections/o/of.md | 1 +
.../a-z-word-list-term-collections/o/off-premises-on-premises.md | 1 +
styleguide/a-z-word-list-term-collections/o/offline.md | 1 +
styleguide/a-z-word-list-term-collections/o/ok-okay.md | 1 +
styleguide/a-z-word-list-term-collections/o/on.md | 1 +
styleguide/a-z-word-list-term-collections/o/onboarding.md | 1 +
styleguide/a-z-word-list-term-collections/o/once.md | 1 +
styleguide/a-z-word-list-term-collections/o/online-services.md | 1 +
styleguide/a-z-word-list-term-collections/o/online.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/n/network-administrator.md b/styleguide/a-z-word-list-term-collections/n/network-administrator.md
index 59b64da9..f2b24425 100644
--- a/styleguide/a-z-word-list-term-collections/n/network-administrator.md
+++ b/styleguide/a-z-word-list-term-collections/n/network-administrator.md
@@ -1,5 +1,6 @@
---
title: network administrator - Microsoft Style Guide
+description: To learn more about using 'network administrator' in Microsoft documents, see 'administrator' or 'admin.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/network-connection.md b/styleguide/a-z-word-list-term-collections/n/network-connection.md
index 87b01e5b..7fdb4902 100644
--- a/styleguide/a-z-word-list-term-collections/n/network-connection.md
+++ b/styleguide/a-z-word-list-term-collections/n/network-connection.md
@@ -1,5 +1,6 @@
---
title: network connection - Microsoft Style Guide
+description: Describes guidelines to use 'network connection' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/network-drive.md b/styleguide/a-z-word-list-term-collections/n/network-drive.md
index 82c68be6..f691f137 100644
--- a/styleguide/a-z-word-list-term-collections/n/network-drive.md
+++ b/styleguide/a-z-word-list-term-collections/n/network-drive.md
@@ -1,5 +1,6 @@
---
title: network drive - Microsoft Style Guide
+description: Describes guidelines to use 'network drive' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/newsreader.md b/styleguide/a-z-word-list-term-collections/n/newsreader.md
index ee503164..0c9af960 100644
--- a/styleguide/a-z-word-list-term-collections/n/newsreader.md
+++ b/styleguide/a-z-word-list-term-collections/n/newsreader.md
@@ -1,5 +1,6 @@
---
title: newsreader - Microsoft Style Guide
+description: Describes guidelines to use 'newsreader' in Microsoft documents - always as a single word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/non.md b/styleguide/a-z-word-list-term-collections/n/non.md
index 3ae8f38e..5b3542da 100644
--- a/styleguide/a-z-word-list-term-collections/n/non.md
+++ b/styleguide/a-z-word-list-term-collections/n/non.md
@@ -1,5 +1,6 @@
---
title: non- - Microsoft Style Guide
+description: Describes guidelines to use the prefix 'non-' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/nonadjacent-selection.md b/styleguide/a-z-word-list-term-collections/n/nonadjacent-selection.md
index 75fc00df..b0f79b7b 100644
--- a/styleguide/a-z-word-list-term-collections/n/nonadjacent-selection.md
+++ b/styleguide/a-z-word-list-term-collections/n/nonadjacent-selection.md
@@ -1,5 +1,6 @@
---
title: nonadjacent selection - Microsoft Style Guide
+description: Describes guidelines to use 'nonadjacent selection' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/noncontiguous-selection.md b/styleguide/a-z-word-list-term-collections/n/noncontiguous-selection.md
index 00d3acc6..53c66ed8 100644
--- a/styleguide/a-z-word-list-term-collections/n/noncontiguous-selection.md
+++ b/styleguide/a-z-word-list-term-collections/n/noncontiguous-selection.md
@@ -1,5 +1,6 @@
---
title: noncontiguous selection - Microsoft Style Guide
+description: Describes guidelines to use 'noncontiguous selection' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/n/nonprintable-nonprinting.md b/styleguide/a-z-word-list-term-collections/n/nonprintable-nonprinting.md
index bc0e85f5..257db617 100644
--- a/styleguide/a-z-word-list-term-collections/n/nonprintable-nonprinting.md
+++ b/styleguide/a-z-word-list-term-collections/n/nonprintable-nonprinting.md
@@ -1,5 +1,6 @@
---
title: nonprintable, nonprinting - Microsoft Style Guide
+description: Describes guidelines to use 'nonprintable' or 'nonprinting' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/normal-normally.md b/styleguide/a-z-word-list-term-collections/n/normal-normally.md
index 66b2b58e..81a5866f 100644
--- a/styleguide/a-z-word-list-term-collections/n/normal-normally.md
+++ b/styleguide/a-z-word-list-term-collections/n/normal-normally.md
@@ -1,5 +1,6 @@
---
title: normal, normally - Microsoft Style Guide
+description: Describes guidelines to use 'normal' or 'normally' in Microsoft documents and provides alternates.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/notification-area.md b/styleguide/a-z-word-list-term-collections/n/notification-area.md
index 51d540db..7619334d 100644
--- a/styleguide/a-z-word-list-term-collections/n/notification-area.md
+++ b/styleguide/a-z-word-list-term-collections/n/notification-area.md
@@ -1,5 +1,6 @@
---
title: notification area - Microsoft Style Guide
+description: Describes guidelines to use 'notification area' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/notification.md b/styleguide/a-z-word-list-term-collections/n/notification.md
index 3103d24a..6c2c6497 100644
--- a/styleguide/a-z-word-list-term-collections/n/notification.md
+++ b/styleguide/a-z-word-list-term-collections/n/notification.md
@@ -1,5 +1,6 @@
---
title: notification - Microsoft Style Guide
+description: Describes guidelines to use 'notification' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/null-terminated-null-terminating.md b/styleguide/a-z-word-list-term-collections/n/null-terminated-null-terminating.md
index bf44a322..04c2cf1f 100644
--- a/styleguide/a-z-word-list-term-collections/n/null-terminated-null-terminating.md
+++ b/styleguide/a-z-word-list-term-collections/n/null-terminated-null-terminating.md
@@ -1,5 +1,6 @@
---
title: null-terminated, null-terminating - Microsoft Style Guide
+description: Describes guidelines to use 'null-terminated' or 'null-terminating' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/null.md b/styleguide/a-z-word-list-term-collections/n/null.md
index 491e5c77..ff269b4a 100644
--- a/styleguide/a-z-word-list-term-collections/n/null.md
+++ b/styleguide/a-z-word-list-term-collections/n/null.md
@@ -1,5 +1,6 @@
---
title: null, NULL, Null - Microsoft Style Guide
+description: Describes guidelines to use 'null' or 'NULL' or 'Null' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/number-sign.md b/styleguide/a-z-word-list-term-collections/n/number-sign.md
index a1f7d34b..e84146c1 100644
--- a/styleguide/a-z-word-list-term-collections/n/number-sign.md
+++ b/styleguide/a-z-word-list-term-collections/n/number-sign.md
@@ -1,5 +1,6 @@
---
title: number sign (\#) - Microsoft Style Guide
+description: Describes guidelines to use the number sign '(\#)' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/n/numeric.md b/styleguide/a-z-word-list-term-collections/n/numeric.md
index 151c95d6..293b6298 100644
--- a/styleguide/a-z-word-list-term-collections/n/numeric.md
+++ b/styleguide/a-z-word-list-term-collections/n/numeric.md
@@ -1,5 +1,6 @@
---
title: numeric - Microsoft Style Guide
+description: Describes guidelines to use 'numeric' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/numbers-symbols/2d-two-dimensional.md b/styleguide/a-z-word-list-term-collections/numbers-symbols/2d-two-dimensional.md
index 954054e5..3ccb4657 100644
--- a/styleguide/a-z-word-list-term-collections/numbers-symbols/2d-two-dimensional.md
+++ b/styleguide/a-z-word-list-term-collections/numbers-symbols/2d-two-dimensional.md
@@ -1,5 +1,6 @@
---
title: 2D, two-dimensional - Microsoft Style Guide
+description: Describes guidelines to use '2D' or 'two-dimensional' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/numbers-symbols/3d-three-dimensional.md b/styleguide/a-z-word-list-term-collections/numbers-symbols/3d-three-dimensional.md
index d79acf38..787c3649 100644
--- a/styleguide/a-z-word-list-term-collections/numbers-symbols/3d-three-dimensional.md
+++ b/styleguide/a-z-word-list-term-collections/numbers-symbols/3d-three-dimensional.md
@@ -1,5 +1,6 @@
---
title: 3D, three-dimensional - Microsoft Style Guide
+description: Describes guidelines to use '3D' or 'three-dimensional' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/numbers-symbols/85-x-11-paper.md b/styleguide/a-z-word-list-term-collections/numbers-symbols/85-x-11-paper.md
index aa99d3ff..49d7e586 100644
--- a/styleguide/a-z-word-list-term-collections/numbers-symbols/85-x-11-paper.md
+++ b/styleguide/a-z-word-list-term-collections/numbers-symbols/85-x-11-paper.md
@@ -1,5 +1,6 @@
---
title: 8.5" x 11" paper - Microsoft Style Guide
+description: Describes guidelines to use '8.5\" x 11\" paper' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/numbers-symbols/twenty-four-seven.md b/styleguide/a-z-word-list-term-collections/numbers-symbols/twenty-four-seven.md
index 4ce4b08c..fbf4ae75 100644
--- a/styleguide/a-z-word-list-term-collections/numbers-symbols/twenty-four-seven.md
+++ b/styleguide/a-z-word-list-term-collections/numbers-symbols/twenty-four-seven.md
@@ -1,5 +1,6 @@
---
title: 24/7 - Microsoft Style Guide
+description: To learn more about using '24/7' in Microsoft documents, see 'Date and time term collection.'
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/object.md b/styleguide/a-z-word-list-term-collections/o/object.md
index 44bb5793..3ab0eb01 100644
--- a/styleguide/a-z-word-list-term-collections/o/object.md
+++ b/styleguide/a-z-word-list-term-collections/o/object.md
@@ -1,5 +1,6 @@
---
title: object - Microsoft Style Guide
+description: Describes guidelines to use 'object' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/obsolete.md b/styleguide/a-z-word-list-term-collections/o/obsolete.md
index d59dc5b4..fccf3f41 100644
--- a/styleguide/a-z-word-list-term-collections/o/obsolete.md
+++ b/styleguide/a-z-word-list-term-collections/o/obsolete.md
@@ -1,5 +1,6 @@
---
title: obsolete - Microsoft Style Guide
+description: Describes guidelines to use 'obsolete' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/of.md b/styleguide/a-z-word-list-term-collections/o/of.md
index d5b7a976..5f57e658 100644
--- a/styleguide/a-z-word-list-term-collections/o/of.md
+++ b/styleguide/a-z-word-list-term-collections/o/of.md
@@ -1,5 +1,6 @@
---
title: of - Microsoft Style Guide
+description: Describes guidelines to use 'of' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/off-premises-on-premises.md b/styleguide/a-z-word-list-term-collections/o/off-premises-on-premises.md
index 01e9a908..ed95548a 100644
--- a/styleguide/a-z-word-list-term-collections/o/off-premises-on-premises.md
+++ b/styleguide/a-z-word-list-term-collections/o/off-premises-on-premises.md
@@ -1,5 +1,6 @@
---
title: off-premises, on-premises - Microsoft Style Guide
+description: Describes guidelines to use 'off-premises' or 'on-premises' in Microsoft documents. See 'Cloud-computing term collection' for more information.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/offline.md b/styleguide/a-z-word-list-term-collections/o/offline.md
index 7251413e..1bd6ab37 100644
--- a/styleguide/a-z-word-list-term-collections/o/offline.md
+++ b/styleguide/a-z-word-list-term-collections/o/offline.md
@@ -1,5 +1,6 @@
---
title: offline - Microsoft Style Guide
+description: Describes guidelines to use 'offline' in Microsoft documents. Use only in the sense of not being connected to or part of a system or network.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/ok-okay.md b/styleguide/a-z-word-list-term-collections/o/ok-okay.md
index c8a93c21..b2d01179 100644
--- a/styleguide/a-z-word-list-term-collections/o/ok-okay.md
+++ b/styleguide/a-z-word-list-term-collections/o/ok-okay.md
@@ -1,5 +1,6 @@
---
title: OK, okay - Microsoft Style Guide
+description: Describes guidelines to use 'OK' or 'okay' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/on.md b/styleguide/a-z-word-list-term-collections/o/on.md
index c52bdf45..528eb2ea 100644
--- a/styleguide/a-z-word-list-term-collections/o/on.md
+++ b/styleguide/a-z-word-list-term-collections/o/on.md
@@ -1,5 +1,6 @@
---
title: on - Microsoft Style Guide
+description: Describes guidelines to use 'on' in Microsoft documents and provides examples. See 'Describing interactions with UI' for more information.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/onboarding.md b/styleguide/a-z-word-list-term-collections/o/onboarding.md
index 9fd62450..1e0dd80d 100644
--- a/styleguide/a-z-word-list-term-collections/o/onboarding.md
+++ b/styleguide/a-z-word-list-term-collections/o/onboarding.md
@@ -1,5 +1,6 @@
---
title: onboarding - Microsoft Style Guide
+description: Describes guidelines to use 'onboarding' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/once.md b/styleguide/a-z-word-list-term-collections/o/once.md
index 793e2805..bccac5f0 100644
--- a/styleguide/a-z-word-list-term-collections/o/once.md
+++ b/styleguide/a-z-word-list-term-collections/o/once.md
@@ -1,5 +1,6 @@
---
title: once - Microsoft Style Guide
+description: Describes guidelines to use 'once' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/online-services.md b/styleguide/a-z-word-list-term-collections/o/online-services.md
index f99fbd52..ab86c446 100644
--- a/styleguide/a-z-word-list-term-collections/o/online-services.md
+++ b/styleguide/a-z-word-list-term-collections/o/online-services.md
@@ -1,5 +1,6 @@
---
title: online services - Microsoft Style Guide
+description: Describes guidelines to use 'online services' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/online.md b/styleguide/a-z-word-list-term-collections/o/online.md
index f4d2fafd..1e5b95b2 100644
--- a/styleguide/a-z-word-list-term-collections/o/online.md
+++ b/styleguide/a-z-word-list-term-collections/o/online.md
@@ -1,5 +1,6 @@
---
title: online - Microsoft Style Guide
+description: Describes guidelines to use 'online' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From a16410d12ee21c226c6f6f72925600be0439e9b5 Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Thu, 2 Jun 2022 21:52:57 -0500
Subject: [PATCH 211/486] Validation: add missing descriptions-cc1
---
styleguide/a-z-word-list-term-collections/w/wellbeing.md | 3 +--
styleguide/a-z-word-list-term-collections/w/where.md | 3 +--
styleguide/a-z-word-list-term-collections/w/while.md | 3 +--
.../a-z-word-list-term-collections/w/white-hat-hacker.md | 3 +--
styleguide/a-z-word-list-term-collections/w/white-paper.md | 3 +--
styleguide/a-z-word-list-term-collections/w/white-space.md | 3 +--
styleguide/a-z-word-list-term-collections/w/who-vs-that.md | 3 +--
styleguide/a-z-word-list-term-collections/w/wi-fi.md | 3 +--
.../a-z-word-list-term-collections/w/wildcard-character.md | 3 +--
styleguide/a-z-word-list-term-collections/w/window.md | 3 +--
.../w/windows-7-windows-8-windows-10.md | 3 +--
.../a-z-word-list-term-collections/w/windows-explorer.md | 3 +--
.../a-z-word-list-term-collections/w/windows-windows-based.md | 3 +--
styleguide/a-z-word-list-term-collections/w/wireframe.md | 3 +--
styleguide/a-z-word-list-term-collections/w/wireless.md | 3 +--
styleguide/a-z-word-list-term-collections/w/wizard.md | 3 +--
styleguide/a-z-word-list-term-collections/w/word-processing.md | 3 +--
.../a-z-word-list-term-collections/w/wordwrap-wordwrapping.md | 3 +--
.../a-z-word-list-term-collections/w/work-area-workspace.md | 3 +--
styleguide/a-z-word-list-term-collections/w/work-style.md | 3 +--
styleguide/a-z-word-list-term-collections/w/workgroup.md | 3 +--
styleguide/a-z-word-list-term-collections/w/working-memory.md | 3 +--
styleguide/a-z-word-list-term-collections/w/workstation.md | 3 +--
styleguide/a-z-word-list-term-collections/w/workstream.md | 3 +--
.../w/worldwide-vs-international.md | 3 +--
25 files changed, 25 insertions(+), 50 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/w/wellbeing.md b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
index 4516e887..03134938 100644
--- a/styleguide/a-z-word-list-term-collections/w/wellbeing.md
+++ b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
@@ -1,10 +1,9 @@
---
title: wellbeing - Microsoft Style Guide
+description: Statement that demonstrates the correct spelling and context of the word "wellbeing" in an example sentence.
author: pallep
ms.author: pallep
ms.date: 05/31/2021
-ms.topic: article
-ms.prod: non-product-specific
---
# wellbeing
diff --git a/styleguide/a-z-word-list-term-collections/w/where.md b/styleguide/a-z-word-list-term-collections/w/where.md
index 85dadcfe..79a0c39b 100644
--- a/styleguide/a-z-word-list-term-collections/w/where.md
+++ b/styleguide/a-z-word-list-term-collections/w/where.md
@@ -1,10 +1,9 @@
---
title: where - Microsoft Style Guide
+description: Statement that uses "where" to introduce a list, as in code or formulas, to define the meaning of elements such as variables or symbols with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# where
diff --git a/styleguide/a-z-word-list-term-collections/w/while.md b/styleguide/a-z-word-list-term-collections/w/while.md
index 56abedde..a188b942 100644
--- a/styleguide/a-z-word-list-term-collections/w/while.md
+++ b/styleguide/a-z-word-list-term-collections/w/while.md
@@ -1,10 +1,9 @@
---
title: while - Microsoft Style Guide
+description: Statement that uses the word "while" to refer to something occurring in time. Don't use as a synonym for although, whereas, on the contrary, or in spite of.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# while
diff --git a/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md b/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
index e544f17f..d57cf3c3 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
@@ -1,10 +1,9 @@
---
title: white hat hacker - Microsoft Style Guide
+description: Statement that instructs to see the Security term collection for "white hat hacker."
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# white hat hacker
diff --git a/styleguide/a-z-word-list-term-collections/w/white-paper.md b/styleguide/a-z-word-list-term-collections/w/white-paper.md
index 41c285f1..adccfd06 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-paper.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-paper.md
@@ -1,10 +1,9 @@
---
title: white paper - Microsoft Style Guide
+description: Statement that shows the term "white paper" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# white paper
diff --git a/styleguide/a-z-word-list-term-collections/w/white-space.md b/styleguide/a-z-word-list-term-collections/w/white-space.md
index f09b5f1e..b12c71e4 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-space.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-space.md
@@ -1,10 +1,9 @@
---
title: white space - Microsoft Style Guide
+description: Statement that states the term "white space" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# white space
diff --git a/styleguide/a-z-word-list-term-collections/w/who-vs-that.md b/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
index 110f017e..40779c3e 100644
--- a/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
+++ b/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
@@ -1,10 +1,9 @@
---
title: who vs. that - Microsoft Style Guide
+description: Demonstrates the terms "who vs. that" by using "who" instead of "that" to introduce clauses referring to people with a Custom Setup example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# who vs. that
diff --git a/styleguide/a-z-word-list-term-collections/w/wi-fi.md b/styleguide/a-z-word-list-term-collections/w/wi-fi.md
index b6fef70f..8e1537fa 100644
--- a/styleguide/a-z-word-list-term-collections/w/wi-fi.md
+++ b/styleguide/a-z-word-list-term-collections/w/wi-fi.md
@@ -1,10 +1,9 @@
---
title: Wi-Fi - Microsoft Style Guide
+description: Explains to use a general phrase instead of Wi-Fi, such as wireless network, or refer to the specific technology that you're describing, such as wireless LAN.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# Wi-Fi
diff --git a/styleguide/a-z-word-list-term-collections/w/wildcard-character.md b/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
index f22dd959..2babe12c 100644
--- a/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
+++ b/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
@@ -1,10 +1,9 @@
---
title: wildcard character - Microsoft Style Guide
+description: Describes how to use the "wildcard character," not just wildcard, to describe a character used to represent one or many characters, such as the asterisk.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# wildcard character
diff --git a/styleguide/a-z-word-list-term-collections/w/window.md b/styleguide/a-z-word-list-term-collections/w/window.md
index 007c22bd..ec09027d 100644
--- a/styleguide/a-z-word-list-term-collections/w/window.md
+++ b/styleguide/a-z-word-list-term-collections/w/window.md
@@ -1,10 +1,9 @@
---
title: window - Microsoft Style Guide
+description: Instructs not to use the term "window" as a verb.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# window
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md b/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
index f483f84b..71581f20 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
@@ -1,10 +1,9 @@
---
title: Windows 7, Windows 8, Windows 10 - Microsoft Style Guide
+description: Instructs to always use the entire name when referring to Windows 7, Windows 8, Windows 10 and to not precede the name with Microsoft.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# Windows 7, Windows 8, Windows 10
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-explorer.md b/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
index c127316a..855c9933 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
@@ -1,10 +1,9 @@
---
title: Windows Explorer - Microsoft Style Guide
+description: Instructs to not use "Windows Explorer" and to see File Explorer for more information.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# Windows Explorer
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md b/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
index 8898df7a..05d350c6 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
@@ -1,10 +1,9 @@
---
title: Windows, Windows-based - Microsoft Style Guide
+description: Instructs to use Windows on "Windows, Windows-based", as a modifier for aspects or elements of the Windows operating system, but not to use Windows-based.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# Windows, Windows-based
diff --git a/styleguide/a-z-word-list-term-collections/w/wireframe.md b/styleguide/a-z-word-list-term-collections/w/wireframe.md
index f9df43cd..94a3d05f 100644
--- a/styleguide/a-z-word-list-term-collections/w/wireframe.md
+++ b/styleguide/a-z-word-list-term-collections/w/wireframe.md
@@ -1,10 +1,9 @@
---
title: wireframe - Microsoft Style Guide
+description: This states that the term "wireframe" is one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# wireframe
diff --git a/styleguide/a-z-word-list-term-collections/w/wireless.md b/styleguide/a-z-word-list-term-collections/w/wireless.md
index 52ac41ed..8bb098fb 100644
--- a/styleguide/a-z-word-list-term-collections/w/wireless.md
+++ b/styleguide/a-z-word-list-term-collections/w/wireless.md
@@ -1,10 +1,9 @@
---
title: wireless - Microsoft Style Guide
+description: Discusses to avoid talking about wireless technology to general users except in the context of connecting to a network.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# wireless
diff --git a/styleguide/a-z-word-list-term-collections/w/wizard.md b/styleguide/a-z-word-list-term-collections/w/wizard.md
index 3c868497..06702aef 100644
--- a/styleguide/a-z-word-list-term-collections/w/wizard.md
+++ b/styleguide/a-z-word-list-term-collections/w/wizard.md
@@ -1,10 +1,9 @@
---
title: wizard - Microsoft Style Guide
+description: Instructs not to use the term "wizard," in general, unless it appears in the UI, but to talk about what the customer needs to do to accomplish the task.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# wizard
diff --git a/styleguide/a-z-word-list-term-collections/w/word-processing.md b/styleguide/a-z-word-list-term-collections/w/word-processing.md
index 5db646fa..0120cd00 100644
--- a/styleguide/a-z-word-list-term-collections/w/word-processing.md
+++ b/styleguide/a-z-word-list-term-collections/w/word-processing.md
@@ -1,10 +1,9 @@
---
title: word processing, word-processing - Microsoft Style Guide
+description: Instructs to use "word processor" or "word processing" as a noun and hyphenate "word-processing" as an adjective.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# word processing, word-processing
diff --git a/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md b/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
index aa1c1389..98c28dd2 100644
--- a/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
+++ b/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
@@ -1,10 +1,9 @@
---
title: wordwrap, wordwrapping - Microsoft Style Guide
+description: Instructs to not use the terms "wordwrap" and "wordwrapping."
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# wordwrap, wordwrapping
diff --git a/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md b/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
index f03f30c8..1a187e20 100644
--- a/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
+++ b/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
@@ -1,10 +1,9 @@
---
title: work area, workspace - Microsoft Style Guide
+description: States that "Work area" is two words and "Workspace" is one word, and instructs not to use UI in general, but to talk about what the customer wants to do.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# work area, workspace
diff --git a/styleguide/a-z-word-list-term-collections/w/work-style.md b/styleguide/a-z-word-list-term-collections/w/work-style.md
index 2fc6c452..3430979e 100644
--- a/styleguide/a-z-word-list-term-collections/w/work-style.md
+++ b/styleguide/a-z-word-list-term-collections/w/work-style.md
@@ -1,10 +1,9 @@
---
title: work style - Microsoft Style Guide
+description: States that the terms "work style" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# work style
diff --git a/styleguide/a-z-word-list-term-collections/w/workgroup.md b/styleguide/a-z-word-list-term-collections/w/workgroup.md
index 7adf311f..a6560e2f 100644
--- a/styleguide/a-z-word-list-term-collections/w/workgroup.md
+++ b/styleguide/a-z-word-list-term-collections/w/workgroup.md
@@ -1,10 +1,9 @@
---
title: workgroup - Microsoft Style Guide
+description: States that the term "workgroup" is one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# workgroup
diff --git a/styleguide/a-z-word-list-term-collections/w/working-memory.md b/styleguide/a-z-word-list-term-collections/w/working-memory.md
index 424bdd46..9a456e99 100644
--- a/styleguide/a-z-word-list-term-collections/w/working-memory.md
+++ b/styleguide/a-z-word-list-term-collections/w/working-memory.md
@@ -1,10 +1,9 @@
---
title: working memory - Microsoft Style Guide
+description: Instructs not to use the terms "working memory," but to use "available memory" instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# working memory
diff --git a/styleguide/a-z-word-list-term-collections/w/workstation.md b/styleguide/a-z-word-list-term-collections/w/workstation.md
index bb1f4893..cf57436b 100644
--- a/styleguide/a-z-word-list-term-collections/w/workstation.md
+++ b/styleguide/a-z-word-list-term-collections/w/workstation.md
@@ -1,10 +1,9 @@
---
title: workstation - Microsoft Style Guide
+description: States that the term "workstation" is one word and instructs to avoid except in discussions of clients and servers.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
---
# workstation
diff --git a/styleguide/a-z-word-list-term-collections/w/workstream.md b/styleguide/a-z-word-list-term-collections/w/workstream.md
index 4ec3e3e8..ff5df0ff 100644
--- a/styleguide/a-z-word-list-term-collections/w/workstream.md
+++ b/styleguide/a-z-word-list-term-collections/w/workstream.md
@@ -1,10 +1,9 @@
---
title: workstream - Microsoft Style Guide
+description: Instructs to use the term "workstream" as one word without a hyphen with an example.
author: pallep
ms.author: pallep
ms.date: 05/31/2021
-ms.topic: article
-ms.prod: non-product-specific
---
# workstream
diff --git a/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md b/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
index 073a15cb..a8e0c58c 100644
--- a/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
+++ b/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
@@ -1,10 +1,9 @@
---
title: worldwide vs. international - Microsoft Style Guide
+description: Instructs to use "worldwide" regarding "worldwide vs. international" to describe something that encompasses all regions or involves the entire world.
author: pallep
ms.author: pallep
ms.date: 11/24/2020
-ms.topic: article
-ms.prod: non-product-specific
---
# worldwide vs. international
From 4aab1f47d24e989f281461192b282e7171a6763b Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Fri, 3 Jun 2022 09:10:23 -0600
Subject: [PATCH 212/486] Bulk Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/s/s-es.md | 1 +
styleguide/a-z-word-list-term-collections/s/secondary-menu.md | 1 +
styleguide/a-z-word-list-term-collections/s/select.md | 1 +
styleguide/a-z-word-list-term-collections/s/server.md | 1 +
.../s/service-level-agreement-sla.md | 1 +
.../s/service-oriented-architecture-soa.md | 1 +
styleguide/a-z-word-list-term-collections/s/set-specify.md | 1 +
styleguide/a-z-word-list-term-collections/s/set-top-box.md | 1 +
styleguide/a-z-word-list-term-collections/s/set-up-setup.md | 1 +
styleguide/a-z-word-list-term-collections/s/setting-value.md | 1 +
styleguide/a-z-word-list-term-collections/s/shaded.md | 1 +
styleguide/a-z-word-list-term-collections/s/shell.md | 1 +
styleguide/a-z-word-list-term-collections/s/ship.md | 1 +
.../a-z-word-list-term-collections/s/shortcut-shortcut-menu.md | 1 +
styleguide/a-z-word-list-term-collections/s/should-vs-must.md | 1 +
.../a-z-word-list-term-collections/s/shut-down-shutdown.md | 1 +
styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md | 1 +
styleguide/a-z-word-list-term-collections/s/simply.md | 1 +
.../a-z-word-list-term-collections/s/single-sign-on-sso.md | 1 +
styleguide/a-z-word-list-term-collections/s/site-map.md | 1 +
styleguide/a-z-word-list-term-collections/s/site.md | 1 +
styleguide/a-z-word-list-term-collections/s/size-resize.md | 1 +
styleguide/a-z-word-list-term-collections/s/sleep.md | 1 +
styleguide/a-z-word-list-term-collections/s/slideshow.md | 1 +
styleguide/a-z-word-list-term-collections/s/small-caps.md | 1 +
styleguide/a-z-word-list-term-collections/s/smart-card.md | 1 +
styleguide/a-z-word-list-term-collections/s/smartphone.md | 1 +
styleguide/a-z-word-list-term-collections/s/smb.md | 1 +
styleguide/a-z-word-list-term-collections/s/snap-in.md | 1 +
styleguide/a-z-word-list-term-collections/s/social-chatbot.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/s/s-es.md b/styleguide/a-z-word-list-term-collections/s/s-es.md
index 1c153ea1..48979cd3 100644
--- a/styleguide/a-z-word-list-term-collections/s/s-es.md
+++ b/styleguide/a-z-word-list-term-collections/s/s-es.md
@@ -1,5 +1,6 @@
---
title: (s), (es) - Microsoft Style Guide
+description: Describes guidelines to use 's' or 'es' in Microsoft documents, and provides an example with a noun usage link.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/secondary-menu.md b/styleguide/a-z-word-list-term-collections/s/secondary-menu.md
index c24cd75b..40ba13e1 100644
--- a/styleguide/a-z-word-list-term-collections/s/secondary-menu.md
+++ b/styleguide/a-z-word-list-term-collections/s/secondary-menu.md
@@ -1,5 +1,6 @@
---
title: secondary menu - Microsoft Style Guide
+description: Describes guidelines to use 'secondary menu' in Microsoft documents, and provides alternate usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/select.md b/styleguide/a-z-word-list-term-collections/s/select.md
index 512044fa..24f77798 100644
--- a/styleguide/a-z-word-list-term-collections/s/select.md
+++ b/styleguide/a-z-word-list-term-collections/s/select.md
@@ -1,5 +1,6 @@
---
title: select - Microsoft Style Guide
+description: Describes guidelines to use 'select' in Microsoft documents, and provides an additional resource link.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/server.md b/styleguide/a-z-word-list-term-collections/s/server.md
index c5c00ee0..14ff3827 100644
--- a/styleguide/a-z-word-list-term-collections/s/server.md
+++ b/styleguide/a-z-word-list-term-collections/s/server.md
@@ -1,5 +1,6 @@
---
title: server - Microsoft Style Guide
+description: Provides a link to a collection of computer and device terms along with their appropriate usage including 'server'.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/service-level-agreement-sla.md b/styleguide/a-z-word-list-term-collections/s/service-level-agreement-sla.md
index c9cb36ad..6fb3b2f1 100644
--- a/styleguide/a-z-word-list-term-collections/s/service-level-agreement-sla.md
+++ b/styleguide/a-z-word-list-term-collections/s/service-level-agreement-sla.md
@@ -1,5 +1,6 @@
---
title: service-level agreement (SLA) - Microsoft Style Guide
+description: Describes guidelines to use 'service-level agreement (SLA)' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 06/27/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/service-oriented-architecture-soa.md b/styleguide/a-z-word-list-term-collections/s/service-oriented-architecture-soa.md
index 301cc07d..4d87ed33 100644
--- a/styleguide/a-z-word-list-term-collections/s/service-oriented-architecture-soa.md
+++ b/styleguide/a-z-word-list-term-collections/s/service-oriented-architecture-soa.md
@@ -1,5 +1,6 @@
---
title: service-oriented architecture (SOA) - Microsoft Style Guide
+description: Provides a link to a collection of cloud-computing terms along with their appropriate usage including 'service-oriented architecture (SOA)'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/set-specify.md b/styleguide/a-z-word-list-term-collections/s/set-specify.md
index 5e89b1a2..8f34154d 100644
--- a/styleguide/a-z-word-list-term-collections/s/set-specify.md
+++ b/styleguide/a-z-word-list-term-collections/s/set-specify.md
@@ -1,5 +1,6 @@
---
title: set, specify - Microsoft Style Guide
+description: Describes guidelines to use 'set' or 'specify' in Microsoft documents, and provides examples with link to common UI interactions.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/set-top-box.md b/styleguide/a-z-word-list-term-collections/s/set-top-box.md
index 4ca8e3a4..12307936 100644
--- a/styleguide/a-z-word-list-term-collections/s/set-top-box.md
+++ b/styleguide/a-z-word-list-term-collections/s/set-top-box.md
@@ -1,5 +1,6 @@
---
title: set-top box - Microsoft Style Guide
+description: Describes guidelines to use 'set-top box' in Microsoft documents. Note hyphen. Don't abbreviate.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/set-up-setup.md b/styleguide/a-z-word-list-term-collections/s/set-up-setup.md
index e24a23cb..897e5fe4 100644
--- a/styleguide/a-z-word-list-term-collections/s/set-up-setup.md
+++ b/styleguide/a-z-word-list-term-collections/s/set-up-setup.md
@@ -1,5 +1,6 @@
---
title: set up, setup, Setup - Microsoft Style Guide
+description: Describes guidelines to use 'set up', 'setup', or 'Setup' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/setting-value.md b/styleguide/a-z-word-list-term-collections/s/setting-value.md
index 4bdb150c..d41c8d39 100644
--- a/styleguide/a-z-word-list-term-collections/s/setting-value.md
+++ b/styleguide/a-z-word-list-term-collections/s/setting-value.md
@@ -1,5 +1,6 @@
---
title: setting, value - Microsoft Style Guide
+description: Describes guidelines to use 'setting' or 'value' in Microsoft documents, and provides alternate usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/shaded.md b/styleguide/a-z-word-list-term-collections/s/shaded.md
index 040294bc..03c526fb 100644
--- a/styleguide/a-z-word-list-term-collections/s/shaded.md
+++ b/styleguide/a-z-word-list-term-collections/s/shaded.md
@@ -1,5 +1,6 @@
---
title: shaded - Microsoft Style Guide
+description: Describes guidelines to use 'shaded' in Microsoft documents, and provides alternate usage examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/s/shell.md b/styleguide/a-z-word-list-term-collections/s/shell.md
index 375e5515..bb600749 100644
--- a/styleguide/a-z-word-list-term-collections/s/shell.md
+++ b/styleguide/a-z-word-list-term-collections/s/shell.md
@@ -1,5 +1,6 @@
---
title: shell - Microsoft Style Guide
+description: Describes guidelines to use 'shell' in Microsoft documents, and provides usage examples. Don't use in content for a general audience.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/ship.md b/styleguide/a-z-word-list-term-collections/s/ship.md
index 418990d1..8a6dec3b 100644
--- a/styleguide/a-z-word-list-term-collections/s/ship.md
+++ b/styleguide/a-z-word-list-term-collections/s/ship.md
@@ -1,5 +1,6 @@
---
title: ship - Microsoft Style Guide
+description: Describes guidelines to use 'ship' in Microsoft documents, and provides alternate usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/shortcut-shortcut-menu.md b/styleguide/a-z-word-list-term-collections/s/shortcut-shortcut-menu.md
index d93bc272..fe06844b 100644
--- a/styleguide/a-z-word-list-term-collections/s/shortcut-shortcut-menu.md
+++ b/styleguide/a-z-word-list-term-collections/s/shortcut-shortcut-menu.md
@@ -1,5 +1,6 @@
---
title: shortcut, shortcut menu - Microsoft Style Guide
+description: Describes guidelines to use 'shortcut' or 'shortcut menu' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/should-vs-must.md b/styleguide/a-z-word-list-term-collections/s/should-vs-must.md
index 9a8f0539..70c3c24f 100644
--- a/styleguide/a-z-word-list-term-collections/s/should-vs-must.md
+++ b/styleguide/a-z-word-list-term-collections/s/should-vs-must.md
@@ -1,5 +1,6 @@
---
title: should vs. must - Microsoft Style Guide
+description: Describes guidelines to use 'should' or 'must' in Microsoft documents, and provides alternate examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/shut-down-shutdown.md b/styleguide/a-z-word-list-term-collections/s/shut-down-shutdown.md
index c20a83cd..0a259f72 100644
--- a/styleguide/a-z-word-list-term-collections/s/shut-down-shutdown.md
+++ b/styleguide/a-z-word-list-term-collections/s/shut-down-shutdown.md
@@ -1,5 +1,6 @@
---
title: shut down, shutdown - Microsoft Style Guide
+description: Describes guidelines to use 'shut down' or 'shutdown' in Microsoft documents, and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md b/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
index 190744b3..bb06a245 100644
--- a/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
+++ b/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
@@ -1,5 +1,6 @@
---
title: sign in, sign out - Microsoft Style Guide
+description: Describes guidelines to use 'sign in' or 'sign out' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 06/27/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/simply.md b/styleguide/a-z-word-list-term-collections/s/simply.md
index 6a476795..a4137c83 100644
--- a/styleguide/a-z-word-list-term-collections/s/simply.md
+++ b/styleguide/a-z-word-list-term-collections/s/simply.md
@@ -1,5 +1,6 @@
---
title: simply - Microsoft Style Guide
+description: Describes guidelines to use 'simply' in Microsoft documents, and provides alternate usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/single-sign-on-sso.md b/styleguide/a-z-word-list-term-collections/s/single-sign-on-sso.md
index a7b704e0..bce29620 100644
--- a/styleguide/a-z-word-list-term-collections/s/single-sign-on-sso.md
+++ b/styleguide/a-z-word-list-term-collections/s/single-sign-on-sso.md
@@ -1,5 +1,6 @@
---
title: single sign-on (SSO) - Microsoft Style Guide
+description: Describes guidelines to use 'single sign-on (SSO)' in Microsoft documents, and provides a link to additional resources.
author: pallep
ms.author: pallep
ms.date: 04/1/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/site-map.md b/styleguide/a-z-word-list-term-collections/s/site-map.md
index 96f3b8ce..849c2cfb 100644
--- a/styleguide/a-z-word-list-term-collections/s/site-map.md
+++ b/styleguide/a-z-word-list-term-collections/s/site-map.md
@@ -1,5 +1,6 @@
---
title: site map - Microsoft Style Guide
+description: Describes guidelines to use 'site map' in Microsoft documents. Two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/site.md b/styleguide/a-z-word-list-term-collections/s/site.md
index 7f431d16..232034b8 100644
--- a/styleguide/a-z-word-list-term-collections/s/site.md
+++ b/styleguide/a-z-word-list-term-collections/s/site.md
@@ -1,5 +1,6 @@
---
title: site - Microsoft Style Guide
+description: Describes guidelines to use 'site' in Microsoft documents, and provides an example wit a link to additional terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/size-resize.md b/styleguide/a-z-word-list-term-collections/s/size-resize.md
index f154f526..133abfea 100644
--- a/styleguide/a-z-word-list-term-collections/s/size-resize.md
+++ b/styleguide/a-z-word-list-term-collections/s/size-resize.md
@@ -1,5 +1,6 @@
---
title: size, resize - Microsoft Style Guide
+description: Describes guidelines to use 'size' or 'resize' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sleep.md b/styleguide/a-z-word-list-term-collections/s/sleep.md
index 40915475..c1013cb2 100644
--- a/styleguide/a-z-word-list-term-collections/s/sleep.md
+++ b/styleguide/a-z-word-list-term-collections/s/sleep.md
@@ -1,5 +1,6 @@
---
title: sleep - Microsoft Style Guide
+description: Describes guidelines to use 'sleep' in Microsoft documents, and provides a link to common computer terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/slideshow.md b/styleguide/a-z-word-list-term-collections/s/slideshow.md
index b8887269..442af521 100644
--- a/styleguide/a-z-word-list-term-collections/s/slideshow.md
+++ b/styleguide/a-z-word-list-term-collections/s/slideshow.md
@@ -1,5 +1,6 @@
---
title: slideshow - Microsoft Style Guide
+description: Describes guidelines to use 'slideshow' in Microsoft documents. One word unless you need to match the UI.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/small-caps.md b/styleguide/a-z-word-list-term-collections/s/small-caps.md
index 429df62f..daa63ef6 100644
--- a/styleguide/a-z-word-list-term-collections/s/small-caps.md
+++ b/styleguide/a-z-word-list-term-collections/s/small-caps.md
@@ -1,5 +1,6 @@
---
title: small caps - Microsoft Style Guide
+description: Describes guidelines to use 'small caps' in Microsoft documents. Don't use small caps for key names or for 'AM' and 'PM'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/smart-card.md b/styleguide/a-z-word-list-term-collections/s/smart-card.md
index df281b99..0e38e697 100644
--- a/styleguide/a-z-word-list-term-collections/s/smart-card.md
+++ b/styleguide/a-z-word-list-term-collections/s/smart-card.md
@@ -1,5 +1,6 @@
---
title: smart card, Smart Card - Microsoft Style Guide
+description: Describes guidelines to use 'smart card' or 'Smart Card' in Microsoft documents. Two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/smartphone.md b/styleguide/a-z-word-list-term-collections/s/smartphone.md
index 239a79d8..a19687e4 100644
--- a/styleguide/a-z-word-list-term-collections/s/smartphone.md
+++ b/styleguide/a-z-word-list-term-collections/s/smartphone.md
@@ -1,5 +1,6 @@
---
title: smartphone - Microsoft Style Guide
+description: Provides a link to a collection of commonly used computer and device terms including 'smartphone'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/smb.md b/styleguide/a-z-word-list-term-collections/s/smb.md
index 5d423496..194cf88c 100644
--- a/styleguide/a-z-word-list-term-collections/s/smb.md
+++ b/styleguide/a-z-word-list-term-collections/s/smb.md
@@ -1,5 +1,6 @@
---
title: SMB - Microsoft Style Guide
+description: Describes guidelines to use 'SMB' in Microsoft documents. Avoid using the acronym.
author: pallep
ms.author: pallep
ms.date: 04/30/2021
diff --git a/styleguide/a-z-word-list-term-collections/s/snap-in.md b/styleguide/a-z-word-list-term-collections/s/snap-in.md
index 39b27641..ad57dd39 100644
--- a/styleguide/a-z-word-list-term-collections/s/snap-in.md
+++ b/styleguide/a-z-word-list-term-collections/s/snap-in.md
@@ -1,5 +1,6 @@
---
title: snap-in - Microsoft Style Guide
+description: Describes guidelines to use 'snap-in' in Microsoft documents. Always hyphenate.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/social-chatbot.md b/styleguide/a-z-word-list-term-collections/s/social-chatbot.md
index e5e20d73..209c7a72 100644
--- a/styleguide/a-z-word-list-term-collections/s/social-chatbot.md
+++ b/styleguide/a-z-word-list-term-collections/s/social-chatbot.md
@@ -1,5 +1,6 @@
---
title: social chatbot - Microsoft Style Guide
+description: Provides a link to a collection of commonly used AI and bot terms including 'social chatbot'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 60b869e56ec1b443ae5402685fe1e0f10a33e708 Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Fri, 3 Jun 2022 09:33:04 -0600
Subject: [PATCH 213/486] fix grammer/typos
---
styleguide/a-z-word-list-term-collections/s/set-specify.md | 2 +-
styleguide/a-z-word-list-term-collections/s/site.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/set-specify.md b/styleguide/a-z-word-list-term-collections/s/set-specify.md
index 8f34154d..afc38edf 100644
--- a/styleguide/a-z-word-list-term-collections/s/set-specify.md
+++ b/styleguide/a-z-word-list-term-collections/s/set-specify.md
@@ -1,6 +1,6 @@
---
title: set, specify - Microsoft Style Guide
-description: Describes guidelines to use 'set' or 'specify' in Microsoft documents, and provides examples with link to common UI interactions.
+description: Describes guidelines to use 'set' or 'specify' in Microsoft documents, and provides examples with a link to common UI interactions.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/site.md b/styleguide/a-z-word-list-term-collections/s/site.md
index 232034b8..3bd9e298 100644
--- a/styleguide/a-z-word-list-term-collections/s/site.md
+++ b/styleguide/a-z-word-list-term-collections/s/site.md
@@ -1,6 +1,6 @@
---
title: site - Microsoft Style Guide
-description: Describes guidelines to use 'site' in Microsoft documents, and provides an example wit a link to additional terms.
+description: Describes guidelines to use 'site' in Microsoft documents, and provides an example with a link to additional terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From aab1754f95af8afa83fe78313615dd45ba5b607b Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Fri, 3 Jun 2022 10:22:01 -0600
Subject: [PATCH 214/486] Bulk Validation: add missing descriptions
---
styleguide/a-z-word-list-term-collections/s/soft-copy.md | 1 +
.../s/software-as-a-service-saas.md | 1 +
.../a-z-word-list-term-collections/s/software-plus-services.md | 1 +
styleguide/a-z-word-list-term-collections/s/sorry.md | 1 +
styleguide/a-z-word-list-term-collections/s/spam.md | 1 +
styleguide/a-z-word-list-term-collections/s/specification.md | 1 +
styleguide/a-z-word-list-term-collections/s/spell-checker.md | 1 +
styleguide/a-z-word-list-term-collections/s/spoofing.md | 1 +
.../a-z-word-list-term-collections/s/spreadsheet-vs-workbook.md | 1 +
styleguide/a-z-word-list-term-collections/s/spyware.md | 1 +
styleguide/a-z-word-list-term-collections/s/sql-sql-server.md | 1 +
styleguide/a-z-word-list-term-collections/s/start-page.md | 1 +
styleguide/a-z-word-list-term-collections/s/start-restart.md | 1 +
styleguide/a-z-word-list-term-collections/s/start-up-startup.md | 1 +
.../a-z-word-list-term-collections/s/stop-stop-responding.md | 1 +
.../a-z-word-list-term-collections/s/storage-storage-device.md | 1 +
.../s/store-marketplace-gallery.md | 1 +
styleguide/a-z-word-list-term-collections/s/stream-streaming.md | 1 +
styleguide/a-z-word-list-term-collections/s/stretch.md | 1 +
styleguide/a-z-word-list-term-collections/s/struct-structure.md | 1 +
styleguide/a-z-word-list-term-collections/s/style-sheet.md | 1 +
styleguide/a-z-word-list-term-collections/s/sub.md | 1 +
styleguide/a-z-word-list-term-collections/s/subaddress.md | 1 +
styleguide/a-z-word-list-term-collections/s/subclass.md | 1 +
styleguide/a-z-word-list-term-collections/s/surf.md | 1 +
styleguide/a-z-word-list-term-collections/s/swipe.md | 1 +
styleguide/a-z-word-list-term-collections/s/switch.md | 1 +
styleguide/a-z-word-list-term-collections/s/sync.md | 1 +
.../a-z-word-list-term-collections/s/system-administrator.md | 1 +
styleguide/a-z-word-list-term-collections/s/system-prompt.md | 1 +
styleguide/a-z-word-list-term-collections/s/system-software.md | 1 +
styleguide/a-z-word-list-term-collections/s/system-tray.md | 1 +
32 files changed, 32 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/s/soft-copy.md b/styleguide/a-z-word-list-term-collections/s/soft-copy.md
index 8f807d8a..d3dae0d7 100644
--- a/styleguide/a-z-word-list-term-collections/s/soft-copy.md
+++ b/styleguide/a-z-word-list-term-collections/s/soft-copy.md
@@ -1,5 +1,6 @@
---
title: soft copy - Microsoft Style Guide
+description: Describes guidelines to use 'soft copy' in Microsoft documents. Don't use. Use a more specific term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/software-as-a-service-saas.md b/styleguide/a-z-word-list-term-collections/s/software-as-a-service-saas.md
index 18665fd6..caaea3f0 100644
--- a/styleguide/a-z-word-list-term-collections/s/software-as-a-service-saas.md
+++ b/styleguide/a-z-word-list-term-collections/s/software-as-a-service-saas.md
@@ -1,5 +1,6 @@
---
title: software as a service (SaaS) - Microsoft Style Guide
+description: Provides a link to commonly used cloud-computing terms in Microsoft documents including 'software as a service (SaaS)'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/software-plus-services.md b/styleguide/a-z-word-list-term-collections/s/software-plus-services.md
index 196ea643..b9e7dd90 100644
--- a/styleguide/a-z-word-list-term-collections/s/software-plus-services.md
+++ b/styleguide/a-z-word-list-term-collections/s/software-plus-services.md
@@ -1,5 +1,6 @@
---
title: software-plus-services - Microsoft Style Guide
+description: Provides a link to commonly used cloud-computing terms in Microsoft documents, including 'software-plus-services'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sorry.md b/styleguide/a-z-word-list-term-collections/s/sorry.md
index f54b4adc..f55cf817 100644
--- a/styleguide/a-z-word-list-term-collections/s/sorry.md
+++ b/styleguide/a-z-word-list-term-collections/s/sorry.md
@@ -1,5 +1,6 @@
---
title: sorry - Microsoft Style Guide
+description: Describes guidelines to use 'sorry' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 07/26/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/spam.md b/styleguide/a-z-word-list-term-collections/s/spam.md
index 0407aa1f..996724ed 100644
--- a/styleguide/a-z-word-list-term-collections/s/spam.md
+++ b/styleguide/a-z-word-list-term-collections/s/spam.md
@@ -1,5 +1,6 @@
---
title: spam - Microsoft Style Guide
+description: Describes guidelines to use 'spam' in Microsoft documents. Don't use to refer generally to commercial email, such as bulk email sent to a customer list.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/specification.md b/styleguide/a-z-word-list-term-collections/s/specification.md
index 62aed19a..f6022a6e 100644
--- a/styleguide/a-z-word-list-term-collections/s/specification.md
+++ b/styleguide/a-z-word-list-term-collections/s/specification.md
@@ -1,5 +1,6 @@
---
title: specification - Microsoft Style Guide
+description: Describes guidelines to use 'specification' in Microsoft documents. Always spell out.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/spell-checker.md b/styleguide/a-z-word-list-term-collections/s/spell-checker.md
index c9b137d4..bd3f8e94 100644
--- a/styleguide/a-z-word-list-term-collections/s/spell-checker.md
+++ b/styleguide/a-z-word-list-term-collections/s/spell-checker.md
@@ -1,5 +1,6 @@
---
title: spell checker - Microsoft Style Guide
+description: Describes guidelines to use 'spell checker' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/spoofing.md b/styleguide/a-z-word-list-term-collections/s/spoofing.md
index 77abbdb1..997e5372 100644
--- a/styleguide/a-z-word-list-term-collections/s/spoofing.md
+++ b/styleguide/a-z-word-list-term-collections/s/spoofing.md
@@ -1,5 +1,6 @@
---
title: spoofing - Microsoft Style Guide
+description: Describes guidelines to use 'spoofing' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/spreadsheet-vs-workbook.md b/styleguide/a-z-word-list-term-collections/s/spreadsheet-vs-workbook.md
index 3c39f155..60659e5d 100644
--- a/styleguide/a-z-word-list-term-collections/s/spreadsheet-vs-workbook.md
+++ b/styleguide/a-z-word-list-term-collections/s/spreadsheet-vs-workbook.md
@@ -1,5 +1,6 @@
---
title: spreadsheet vs. workbook - Microsoft Style Guide
+description: Describes guidelines to use 'spreadsheet' or 'workbook' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/spyware.md b/styleguide/a-z-word-list-term-collections/s/spyware.md
index f6301105..14fb62d4 100644
--- a/styleguide/a-z-word-list-term-collections/s/spyware.md
+++ b/styleguide/a-z-word-list-term-collections/s/spyware.md
@@ -1,5 +1,6 @@
---
title: spyware - Microsoft Style Guide
+description: Provides a link to commonly used security terms in Microsoft documents including 'spyware'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md b/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
index d9498e96..4036c3aa 100644
--- a/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
+++ b/styleguide/a-z-word-list-term-collections/s/sql-sql-server.md
@@ -1,5 +1,6 @@
---
title: SQL, SQL Server - Microsoft Style Guide
+description: Describes guidelines to use 'SQL' or 'SQL Server' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 12/09/2021
diff --git a/styleguide/a-z-word-list-term-collections/s/start-page.md b/styleguide/a-z-word-list-term-collections/s/start-page.md
index 61995a7c..098d164d 100644
--- a/styleguide/a-z-word-list-term-collections/s/start-page.md
+++ b/styleguide/a-z-word-list-term-collections/s/start-page.md
@@ -1,5 +1,6 @@
---
title: start page - Microsoft Style Guide
+description: Describes guidelines to use 'start page' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/start-restart.md b/styleguide/a-z-word-list-term-collections/s/start-restart.md
index 29829648..59d9584d 100644
--- a/styleguide/a-z-word-list-term-collections/s/start-restart.md
+++ b/styleguide/a-z-word-list-term-collections/s/start-restart.md
@@ -1,5 +1,6 @@
---
title: start, restart - Microsoft Style Guide
+description: Describes guidelines to use 'start' or 'restart' in Microsoft documents, and provides additional reference links.
author: pallep
ms.author: pallep
ms.date: 04/30/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/start-up-startup.md b/styleguide/a-z-word-list-term-collections/s/start-up-startup.md
index 9a82c031..791bc7d6 100644
--- a/styleguide/a-z-word-list-term-collections/s/start-up-startup.md
+++ b/styleguide/a-z-word-list-term-collections/s/start-up-startup.md
@@ -1,5 +1,6 @@
---
title: start up, startup - Microsoft Style Guide
+description: Describes guidelines to use 'start up' or 'startup' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/stop-stop-responding.md b/styleguide/a-z-word-list-term-collections/s/stop-stop-responding.md
index b914fb34..0232c4b9 100644
--- a/styleguide/a-z-word-list-term-collections/s/stop-stop-responding.md
+++ b/styleguide/a-z-word-list-term-collections/s/stop-stop-responding.md
@@ -1,5 +1,6 @@
---
title: stop, stop responding - Microsoft Style Guide
+description: Describes guidelines to use 'stop' or 'stop responding' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md b/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
index 982f725b..e7fd95ab 100644
--- a/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
+++ b/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
@@ -1,5 +1,6 @@
---
title: storage, storage device - Microsoft Style Guide
+description: Describes guidelines to use 'storage' or 'storage device' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/store-marketplace-gallery.md b/styleguide/a-z-word-list-term-collections/s/store-marketplace-gallery.md
index 8008039f..4c50196e 100644
--- a/styleguide/a-z-word-list-term-collections/s/store-marketplace-gallery.md
+++ b/styleguide/a-z-word-list-term-collections/s/store-marketplace-gallery.md
@@ -1,5 +1,6 @@
---
title: store, marketplace, gallery - Microsoft Style Guide
+description: Describes guidelines to use 'store', 'marketplace', or 'storage device' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/stream-streaming.md b/styleguide/a-z-word-list-term-collections/s/stream-streaming.md
index 5090959a..68f59b4b 100644
--- a/styleguide/a-z-word-list-term-collections/s/stream-streaming.md
+++ b/styleguide/a-z-word-list-term-collections/s/stream-streaming.md
@@ -1,5 +1,6 @@
---
title: stream, streaming - Microsoft Style Guide
+description: Describes guidelines to use 'stream' or 'streaming' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/stretch.md b/styleguide/a-z-word-list-term-collections/s/stretch.md
index e4057bf7..843dfc86 100644
--- a/styleguide/a-z-word-list-term-collections/s/stretch.md
+++ b/styleguide/a-z-word-list-term-collections/s/stretch.md
@@ -1,5 +1,6 @@
---
title: stretch - Microsoft Style Guide
+description: Provides a link to commonly used touch and pen interaction terms in Microsoft documents including 'stretch'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/struct-structure.md b/styleguide/a-z-word-list-term-collections/s/struct-structure.md
index 683c2a26..0fca72c6 100644
--- a/styleguide/a-z-word-list-term-collections/s/struct-structure.md
+++ b/styleguide/a-z-word-list-term-collections/s/struct-structure.md
@@ -1,5 +1,6 @@
---
title: struct, structure - Microsoft Style Guide
+description: Describes guidelines to use 'struct' or 'structure' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/style-sheet.md b/styleguide/a-z-word-list-term-collections/s/style-sheet.md
index 5963a5db..89fe6317 100644
--- a/styleguide/a-z-word-list-term-collections/s/style-sheet.md
+++ b/styleguide/a-z-word-list-term-collections/s/style-sheet.md
@@ -1,5 +1,6 @@
---
title: style sheet - Microsoft Style Guide
+description: Describes guidelines to use 'style sheet' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sub.md b/styleguide/a-z-word-list-term-collections/s/sub.md
index c5ced023..d4e190c3 100644
--- a/styleguide/a-z-word-list-term-collections/s/sub.md
+++ b/styleguide/a-z-word-list-term-collections/s/sub.md
@@ -1,5 +1,6 @@
---
title: sub- - Microsoft Style Guide
+description: Describes guidelines to use 'sub-' in Microsoft documents, and provides a link to learn more about hyphenation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/subaddress.md b/styleguide/a-z-word-list-term-collections/s/subaddress.md
index 9e9fed68..b9cfd5cc 100644
--- a/styleguide/a-z-word-list-term-collections/s/subaddress.md
+++ b/styleguide/a-z-word-list-term-collections/s/subaddress.md
@@ -1,5 +1,6 @@
---
title: subaddress - Microsoft Style Guide
+description: Describes guidelines to use 'subaddress' in Microsoft documents. Use a more specific term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/subclass.md b/styleguide/a-z-word-list-term-collections/s/subclass.md
index 42eb4593..eaf1cb01 100644
--- a/styleguide/a-z-word-list-term-collections/s/subclass.md
+++ b/styleguide/a-z-word-list-term-collections/s/subclass.md
@@ -1,5 +1,6 @@
---
title: subclass - Microsoft Style Guide
+description: Describes guidelines to use 'subclass' in Microsoft documents. Don't use as a verb.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/surf.md b/styleguide/a-z-word-list-term-collections/s/surf.md
index 7a5cbe95..1cf5fba8 100644
--- a/styleguide/a-z-word-list-term-collections/s/surf.md
+++ b/styleguide/a-z-word-list-term-collections/s/surf.md
@@ -1,5 +1,6 @@
---
title: surf - Microsoft Style Guide
+description: Describes guidelines to use 'surf' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/swipe.md b/styleguide/a-z-word-list-term-collections/s/swipe.md
index 4bc827bd..330bf546 100644
--- a/styleguide/a-z-word-list-term-collections/s/swipe.md
+++ b/styleguide/a-z-word-list-term-collections/s/swipe.md
@@ -1,5 +1,6 @@
---
title: swipe - Microsoft Style Guide
+description: Provides a link to commonly used touch and pen interaction terms in Microsoft documents including 'swipe'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/switch.md b/styleguide/a-z-word-list-term-collections/s/switch.md
index 5c8b1400..90544678 100644
--- a/styleguide/a-z-word-list-term-collections/s/switch.md
+++ b/styleguide/a-z-word-list-term-collections/s/switch.md
@@ -1,5 +1,6 @@
---
title: switch - Microsoft Style Guide
+description: Describes guidelines to use 'switch' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/s/sync.md b/styleguide/a-z-word-list-term-collections/s/sync.md
index 735b3c4f..8bc3ed6a 100644
--- a/styleguide/a-z-word-list-term-collections/s/sync.md
+++ b/styleguide/a-z-word-list-term-collections/s/sync.md
@@ -1,5 +1,6 @@
---
title: sync - Microsoft Style Guide
+description: Describes guidelines to use 'sync' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/system-administrator.md b/styleguide/a-z-word-list-term-collections/s/system-administrator.md
index 79e89c51..28f3cc10 100644
--- a/styleguide/a-z-word-list-term-collections/s/system-administrator.md
+++ b/styleguide/a-z-word-list-term-collections/s/system-administrator.md
@@ -1,5 +1,6 @@
---
title: system administrator - Microsoft Style Guide
+description: Provides a link to commonly used terms in Microsoft documents including 'system administrator'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/system-prompt.md b/styleguide/a-z-word-list-term-collections/s/system-prompt.md
index 3cc23e3a..97b55835 100644
--- a/styleguide/a-z-word-list-term-collections/s/system-prompt.md
+++ b/styleguide/a-z-word-list-term-collections/s/system-prompt.md
@@ -1,5 +1,6 @@
---
title: system prompt - Microsoft Style Guide
+description: Provides a link to commonly used terms in Microsoft documents including 'system prompt'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/system-software.md b/styleguide/a-z-word-list-term-collections/s/system-software.md
index af9a4e5e..614e1532 100644
--- a/styleguide/a-z-word-list-term-collections/s/system-software.md
+++ b/styleguide/a-z-word-list-term-collections/s/system-software.md
@@ -1,5 +1,6 @@
---
title: system software - Microsoft Style Guide
+description: Describes guidelines to use 'system software' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/system-tray.md b/styleguide/a-z-word-list-term-collections/s/system-tray.md
index 340cbaba..447e9a3c 100644
--- a/styleguide/a-z-word-list-term-collections/s/system-tray.md
+++ b/styleguide/a-z-word-list-term-collections/s/system-tray.md
@@ -1,5 +1,6 @@
---
title: system tray - Microsoft Style Guide
+description: Describes guidelines to use 'system tray' in Microsoft documents, and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 5be4b39a2273a068ea69ffd0fc48592ea4dfbcbd Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Fri, 3 Jun 2022 10:27:49 -0600
Subject: [PATCH 215/486] bring 2 files that got left behind
---
styleguide/a-z-word-list-term-collections/t/tab.md | 1 +
styleguide/a-z-word-list-term-collections/t/table-of-contents.md | 1 +
2 files changed, 2 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/t/tab.md b/styleguide/a-z-word-list-term-collections/t/tab.md
index 82868add..43c75dcd 100644
--- a/styleguide/a-z-word-list-term-collections/t/tab.md
+++ b/styleguide/a-z-word-list-term-collections/t/tab.md
@@ -1,5 +1,6 @@
---
title: tab - Microsoft Style Guide
+description: Describes guidelines to use 'tab' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/t/table-of-contents.md b/styleguide/a-z-word-list-term-collections/t/table-of-contents.md
index 39f6eead..8fb48027 100644
--- a/styleguide/a-z-word-list-term-collections/t/table-of-contents.md
+++ b/styleguide/a-z-word-list-term-collections/t/table-of-contents.md
@@ -1,5 +1,6 @@
---
title: table of contents - Microsoft Style Guide
+description: Describes guidelines to use 'table of contents' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From ae39fed2bf9a7025047afdb96efbe37ccc8ff3f7 Mon Sep 17 00:00:00 2001
From: brittmsantos <104656243+brittmsantos@users.noreply.github.com>
Date: Fri, 3 Jun 2022 13:48:07 -0400
Subject: [PATCH 216/486] Description-missing fixes.
---
styleguide/a-z-word-list-term-collections/c/control-panel.md | 1 +
styleguide/a-z-word-list-term-collections/c/controller.md | 1 +
.../c/conversation-as-a-platform-caap.md | 1 +
.../c/conversational-user-interface-cui.md | 1 +
styleguide/a-z-word-list-term-collections/c/corrupted.md | 1 +
styleguide/a-z-word-list-term-collections/c/country-or-region.md | 1 +
styleguide/a-z-word-list-term-collections/c/crash.md | 1 +
styleguide/a-z-word-list-term-collections/c/cut-and-paste.md | 1 +
styleguide/a-z-word-list-term-collections/c/cyber.md | 1 +
styleguide/a-z-word-list-term-collections/c/dash-core.md | 1 +
styleguide/a-z-word-list-term-collections/d/dark-mode.md | 1 +
styleguide/a-z-word-list-term-collections/d/data-binding.md | 1 +
styleguide/a-z-word-list-term-collections/d/data-datum.md | 1 +
styleguide/a-z-word-list-term-collections/d/data-record.md | 1 +
styleguide/a-z-word-list-term-collections/d/database.md | 1 +
styleguide/a-z-word-list-term-collections/d/datacenter.md | 1 +
styleguide/a-z-word-list-term-collections/d/datagram.md | 1 +
.../a-z-word-list-term-collections/d/deaf-or-hard-of-hearing.md | 1 +
styleguide/a-z-word-list-term-collections/d/debug.md | 1 +
.../a-z-word-list-term-collections/d/deceptive-software.md | 1 +
styleguide/a-z-word-list-term-collections/d/decrement.md | 1 +
styleguide/a-z-word-list-term-collections/d/default.md | 1 +
styleguide/a-z-word-list-term-collections/d/defragment.md | 1 +
styleguide/a-z-word-list-term-collections/d/deinstall.md | 1 +
styleguide/a-z-word-list-term-collections/d/delete.md | 1 +
.../a-z-word-list-term-collections/d/demilitarized-zone-dmz.md | 1 +
styleguide/a-z-word-list-term-collections/d/deprecated.md | 1 +
styleguide/a-z-word-list-term-collections/d/depress-depressed.md | 1 +
28 files changed, 28 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/c/control-panel.md b/styleguide/a-z-word-list-term-collections/c/control-panel.md
index e637b929..5fc48eb9 100644
--- a/styleguide/a-z-word-list-term-collections/c/control-panel.md
+++ b/styleguide/a-z-word-list-term-collections/c/control-panel.md
@@ -1,5 +1,6 @@
---
title: Control Panel - Microsoft Style Guide
+description: Describes how to use and style the term 'Control Panel' in Microsoft content depending on the context and provides examples for using the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/controller.md b/styleguide/a-z-word-list-term-collections/c/controller.md
index 6e3cdea4..334ef6e0 100644
--- a/styleguide/a-z-word-list-term-collections/c/controller.md
+++ b/styleguide/a-z-word-list-term-collections/c/controller.md
@@ -1,5 +1,6 @@
---
title: controller - Microsoft Style Guide
+description: Provides a link to the computer and device term collection topic as it pertains to the term 'controller'.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/c/conversation-as-a-platform-caap.md b/styleguide/a-z-word-list-term-collections/c/conversation-as-a-platform-caap.md
index d8644031..b4c0fe86 100644
--- a/styleguide/a-z-word-list-term-collections/c/conversation-as-a-platform-caap.md
+++ b/styleguide/a-z-word-list-term-collections/c/conversation-as-a-platform-caap.md
@@ -1,5 +1,6 @@
---
title: conversation as a platform - Microsoft Style Guide
+description: Provides a link to the AI and bot term collection topic as it pertains to the term 'conversation as a platform (CaaP)'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/conversational-user-interface-cui.md b/styleguide/a-z-word-list-term-collections/c/conversational-user-interface-cui.md
index 8fe45cae..3fc88086 100644
--- a/styleguide/a-z-word-list-term-collections/c/conversational-user-interface-cui.md
+++ b/styleguide/a-z-word-list-term-collections/c/conversational-user-interface-cui.md
@@ -1,5 +1,6 @@
---
title: conversational user interface (CUI) - Microsoft Style Guide
+description: Provides a link to the AI and bot term collection topic as it pertains to the term 'conversational user interface (CUI)'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/corrupted.md b/styleguide/a-z-word-list-term-collections/c/corrupted.md
index 821a776a..3a6ea5e5 100644
--- a/styleguide/a-z-word-list-term-collections/c/corrupted.md
+++ b/styleguide/a-z-word-list-term-collections/c/corrupted.md
@@ -1,5 +1,6 @@
---
title: corrupted - Microsoft Style Guide
+description: Describes how to use the term 'corrupted' in Microsoft content and provides alternatives to the term with examples of their usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/country-or-region.md b/styleguide/a-z-word-list-term-collections/c/country-or-region.md
index 56e02332..1ba8e474 100644
--- a/styleguide/a-z-word-list-term-collections/c/country-or-region.md
+++ b/styleguide/a-z-word-list-term-collections/c/country-or-region.md
@@ -1,5 +1,6 @@
---
title: country or region - Microsoft Style Guide
+description: Describes how to use the terms 'country' or 'region' in Microsoft content depending on context and provides examples of their usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/crash.md b/styleguide/a-z-word-list-term-collections/c/crash.md
index c3dedac3..61152373 100644
--- a/styleguide/a-z-word-list-term-collections/c/crash.md
+++ b/styleguide/a-z-word-list-term-collections/c/crash.md
@@ -1,5 +1,6 @@
---
title: crash - Microsoft Style Guide
+description: Describes how to use the term 'crash' in Microsoft content and provides alternatives to the term to use instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cut-and-paste.md b/styleguide/a-z-word-list-term-collections/c/cut-and-paste.md
index 200eaec9..2c719784 100644
--- a/styleguide/a-z-word-list-term-collections/c/cut-and-paste.md
+++ b/styleguide/a-z-word-list-term-collections/c/cut-and-paste.md
@@ -1,5 +1,6 @@
---
title: cut, cut-and-paste - Microsoft Style Guide
+description: Describes how to use the terms 'cut' and 'cut-and-paste' in Microsoft content depending on context and provides examples of their usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cyber.md b/styleguide/a-z-word-list-term-collections/c/cyber.md
index fcb222ca..5099b7b3 100644
--- a/styleguide/a-z-word-list-term-collections/c/cyber.md
+++ b/styleguide/a-z-word-list-term-collections/c/cyber.md
@@ -1,5 +1,6 @@
---
title: cyber- - Microsoft Style Guide
+description: Describes how to use the prefix 'cyber-' in Microsoft content and clarifies how to handle hyphenating terms that use the prefix.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/dash-core.md b/styleguide/a-z-word-list-term-collections/c/dash-core.md
index 600cbe4e..73fbea6f 100644
--- a/styleguide/a-z-word-list-term-collections/c/dash-core.md
+++ b/styleguide/a-z-word-list-term-collections/c/dash-core.md
@@ -1,5 +1,6 @@
---
title: \-core - Microsoft Style Guide
+description: Describes the suffix "-core" in Microsoft content and clarifies how to handle hyphenating terms that use the suffix.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/dark-mode.md b/styleguide/a-z-word-list-term-collections/d/dark-mode.md
index ef983505..09e48969 100644
--- a/styleguide/a-z-word-list-term-collections/d/dark-mode.md
+++ b/styleguide/a-z-word-list-term-collections/d/dark-mode.md
@@ -1,5 +1,6 @@
---
title: dark mode - Microsoft Style Guide
+description: Describes how to use the term 'dark mode' in Microsoft content and provides examples of the term being used.
author: pallep
ms.author: pallep
ms.date: 04/30/2021
diff --git a/styleguide/a-z-word-list-term-collections/d/data-binding.md b/styleguide/a-z-word-list-term-collections/d/data-binding.md
index 6ce743ea..3cc85ae2 100644
--- a/styleguide/a-z-word-list-term-collections/d/data-binding.md
+++ b/styleguide/a-z-word-list-term-collections/d/data-binding.md
@@ -1,5 +1,6 @@
---
title: data binding - Microsoft Style Guide
+description: Clarifies that the term 'data binding' should be spelled as two words in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/data-datum.md b/styleguide/a-z-word-list-term-collections/d/data-datum.md
index bf24104d..45a8f4e1 100644
--- a/styleguide/a-z-word-list-term-collections/d/data-datum.md
+++ b/styleguide/a-z-word-list-term-collections/d/data-datum.md
@@ -1,5 +1,6 @@
---
title: data, datum - Microsoft Style Guide
+description: Describes how to use the terms 'data' and 'datum' in Mirosoft content depending on context and provides examples of their usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/data-record.md b/styleguide/a-z-word-list-term-collections/d/data-record.md
index 8770fff6..7463c7a1 100644
--- a/styleguide/a-z-word-list-term-collections/d/data-record.md
+++ b/styleguide/a-z-word-list-term-collections/d/data-record.md
@@ -1,5 +1,6 @@
---
title: data record - Microsoft Style Guide
+description: Describes how to use the term 'data record' in Microsoft content and provides an alternative to use instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/database.md b/styleguide/a-z-word-list-term-collections/d/database.md
index 751e8544..2979655e 100644
--- a/styleguide/a-z-word-list-term-collections/d/database.md
+++ b/styleguide/a-z-word-list-term-collections/d/database.md
@@ -1,5 +1,6 @@
---
title: database - Microsoft Style Guide
+description: Clarifies that the term 'database' should be spelled as one word in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/datacenter.md b/styleguide/a-z-word-list-term-collections/d/datacenter.md
index f4f0ae8b..eb1bd959 100644
--- a/styleguide/a-z-word-list-term-collections/d/datacenter.md
+++ b/styleguide/a-z-word-list-term-collections/d/datacenter.md
@@ -1,5 +1,6 @@
---
title: datacenter - Microsoft Style Guide
+description: Clarifies that the term 'datacenter' should be spelled as one word in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/datagram.md b/styleguide/a-z-word-list-term-collections/d/datagram.md
index e948da66..b48b7c2c 100644
--- a/styleguide/a-z-word-list-term-collections/d/datagram.md
+++ b/styleguide/a-z-word-list-term-collections/d/datagram.md
@@ -1,5 +1,6 @@
---
title: datagram - Microsoft Style Guide
+description: Clarifies that the term 'datagram' should be spelled as one word in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/deaf-or-hard-of-hearing.md b/styleguide/a-z-word-list-term-collections/d/deaf-or-hard-of-hearing.md
index 332709a9..b08b9042 100644
--- a/styleguide/a-z-word-list-term-collections/d/deaf-or-hard-of-hearing.md
+++ b/styleguide/a-z-word-list-term-collections/d/deaf-or-hard-of-hearing.md
@@ -1,5 +1,6 @@
---
title: deaf or hard-of-hearing - Microsoft Style Guide
+description: Provides a link to the Accessibility term collection topic as it pertains to the terms 'deaf' or 'hard-of-hearing'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/debug.md b/styleguide/a-z-word-list-term-collections/d/debug.md
index a1e1541f..ca760f62 100644
--- a/styleguide/a-z-word-list-term-collections/d/debug.md
+++ b/styleguide/a-z-word-list-term-collections/d/debug.md
@@ -1,5 +1,6 @@
---
title: debug - Microsoft Style Guide
+description: Describes how to use the term 'debug' in Microsoft content depending on context and clarifies the term cannot be used as a synonym for 'troubleshoot'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/deceptive-software.md b/styleguide/a-z-word-list-term-collections/d/deceptive-software.md
index de671560..f88bc770 100644
--- a/styleguide/a-z-word-list-term-collections/d/deceptive-software.md
+++ b/styleguide/a-z-word-list-term-collections/d/deceptive-software.md
@@ -1,5 +1,6 @@
---
title: deceptive software - Microsoft Style Guide
+description: Provides a link to the Security term collection topic as it pertains to the term 'deceptive software'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/decrement.md b/styleguide/a-z-word-list-term-collections/d/decrement.md
index c6ac0c0e..c09622ce 100644
--- a/styleguide/a-z-word-list-term-collections/d/decrement.md
+++ b/styleguide/a-z-word-list-term-collections/d/decrement.md
@@ -1,5 +1,6 @@
---
title: decrement - Microsoft Style Guide
+description: Describes how to use the term 'decrement' in Microsoft content depending on the audience and when to use the term as a verb and as an adjective.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/default.md b/styleguide/a-z-word-list-term-collections/d/default.md
index e00fbae0..6ba92ab7 100644
--- a/styleguide/a-z-word-list-term-collections/d/default.md
+++ b/styleguide/a-z-word-list-term-collections/d/default.md
@@ -1,5 +1,6 @@
---
title: default - Microsoft Style Guide
+description: Describes how to use the term 'default' in Microsoft content and provides examples of the term's usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/defragment.md b/styleguide/a-z-word-list-term-collections/d/defragment.md
index 8e541696..8a70ab82 100644
--- a/styleguide/a-z-word-list-term-collections/d/defragment.md
+++ b/styleguide/a-z-word-list-term-collections/d/defragment.md
@@ -1,5 +1,6 @@
---
title: defragment - Microsoft Style Guide
+description: Clarifies how to abbreviate the term 'defrag' in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/deinstall.md b/styleguide/a-z-word-list-term-collections/d/deinstall.md
index ec3dcb40..2c9b3b75 100644
--- a/styleguide/a-z-word-list-term-collections/d/deinstall.md
+++ b/styleguide/a-z-word-list-term-collections/d/deinstall.md
@@ -1,5 +1,6 @@
---
title: deinstall - Microsoft Style Guide
+description: Describes how to use the term 'deinstall' in Microsoft content and provides an example of the term's usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/delete.md b/styleguide/a-z-word-list-term-collections/d/delete.md
index c8988869..691f3a31 100644
--- a/styleguide/a-z-word-list-term-collections/d/delete.md
+++ b/styleguide/a-z-word-list-term-collections/d/delete.md
@@ -1,5 +1,6 @@
---
title: delete - Microsoft Style Guide
+description: Describes how to use the term 'delete' in Microsoft content and provides examples of the term's usage.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/demilitarized-zone-dmz.md b/styleguide/a-z-word-list-term-collections/d/demilitarized-zone-dmz.md
index 3ea70dbe..324d68d5 100644
--- a/styleguide/a-z-word-list-term-collections/d/demilitarized-zone-dmz.md
+++ b/styleguide/a-z-word-list-term-collections/d/demilitarized-zone-dmz.md
@@ -1,5 +1,6 @@
---
title: demilitarized zone (DMZ) - Microsoft Style Guide
+description: Describes how to use the term 'demilitarized zone' in Microsoft content and provides alternative terms to be used instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/deprecated.md b/styleguide/a-z-word-list-term-collections/d/deprecated.md
index 66043aad..92856c0a 100644
--- a/styleguide/a-z-word-list-term-collections/d/deprecated.md
+++ b/styleguide/a-z-word-list-term-collections/d/deprecated.md
@@ -1,5 +1,6 @@
---
title: deprecated - Microsoft Style Guide
+description: Describes how to use the term 'deprecated' in Microsoft content for different audiences and provides alternatives to use instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/d/depress-depressed.md b/styleguide/a-z-word-list-term-collections/d/depress-depressed.md
index 240ec387..a585e1b5 100644
--- a/styleguide/a-z-word-list-term-collections/d/depress-depressed.md
+++ b/styleguide/a-z-word-list-term-collections/d/depress-depressed.md
@@ -1,5 +1,6 @@
---
title: depress, depressed - Microsoft Style Guide
+description: Provides a link to the Keys and keyboard shortcuts term collection topic as it pertains to the terms 'depress' and 'depressed'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 26968c805e6a9becb51d49c17e74163c456493fa Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 11:42:48 -0700
Subject: [PATCH 217/486] BULK VALIDATION missing descriptions 1
---
styleguide/a-z-word-list-term-collections/g/global.md | 1 +
styleguide/a-z-word-list-term-collections/g/glyph.md | 1 +
styleguide/a-z-word-list-term-collections/g/go-to.md | 1 +
.../g/graphic-graphics-graphical.md | 1 +
styleguide/a-z-word-list-term-collections/g/graphics-adapter.md | 1 +
styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md | 1 +
styleguide/a-z-word-list-term-collections/g/greater-better.md | 1 +
styleguide/a-z-word-list-term-collections/g/greylist.md | 1 +
styleguide/a-z-word-list-term-collections/g/gridline.md | 1 +
styleguide/a-z-word-list-term-collections/g/group-box.md | 1 +
styleguide/a-z-word-list-term-collections/g/group-newsgroup.md | 1 +
styleguide/a-z-word-list-term-collections/g/grow.md | 1 +
styleguide/a-z-word-list-term-collections/h/hack-hacker.md | 1 +
styleguide/a-z-word-list-term-collections/h/half-inch.md | 1 +
.../a-z-word-list-term-collections/h/handheld-handheld-device.md | 1 +
styleguide/a-z-word-list-term-collections/h/handle.md | 1 +
styleguide/a-z-word-list-term-collections/h/handshake.md | 1 +
styleguide/a-z-word-list-term-collections/h/hang.md | 1 +
.../h/hard-code-hard-coded-hard-coding.md | 1 +
styleguide/a-z-word-list-term-collections/h/hard-copy.md | 1 +
styleguide/a-z-word-list-term-collections/h/hard-drive.md | 1 +
styleguide/a-z-word-list-term-collections/h/hard-of-hearing.md | 1 +
styleguide/a-z-word-list-term-collections/h/hardwired.md | 1 +
styleguide/a-z-word-list-term-collections/h/hdmi.md | 1 +
styleguide/a-z-word-list-term-collections/h/he-she.md | 1 +
styleguide/a-z-word-list-term-collections/h/header.md | 1 +
styleguide/a-z-word-list-term-collections/h/heading.md | 1 +
styleguide/a-z-word-list-term-collections/h/hearing-impaired.md | 1 +
styleguide/a-z-word-list-term-collections/h/help.md | 1 +
styleguide/a-z-word-list-term-collections/h/hexadecimal.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/g/global.md b/styleguide/a-z-word-list-term-collections/g/global.md
index 93f944ed..ee4b9000 100644
--- a/styleguide/a-z-word-list-term-collections/g/global.md
+++ b/styleguide/a-z-word-list-term-collections/g/global.md
@@ -1,5 +1,6 @@
---
title: global - Microsoft Style Guide
+description: Describes how to use the term "global" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/glyph.md b/styleguide/a-z-word-list-term-collections/g/glyph.md
index 0b1b6f97..64fe4d0d 100644
--- a/styleguide/a-z-word-list-term-collections/g/glyph.md
+++ b/styleguide/a-z-word-list-term-collections/g/glyph.md
@@ -1,5 +1,6 @@
---
title: glyph - Microsoft Style Guide
+description: Describes how to use the term "glyph" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/go-to.md b/styleguide/a-z-word-list-term-collections/g/go-to.md
index 232a8eb5..57f27903 100644
--- a/styleguide/a-z-word-list-term-collections/g/go-to.md
+++ b/styleguide/a-z-word-list-term-collections/g/go-to.md
@@ -1,5 +1,6 @@
---
title: go to - Microsoft Style Guide
+description: Describes how to use the term "go to" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/graphic-graphics-graphical.md b/styleguide/a-z-word-list-term-collections/g/graphic-graphics-graphical.md
index 52281158..3a220de6 100644
--- a/styleguide/a-z-word-list-term-collections/g/graphic-graphics-graphical.md
+++ b/styleguide/a-z-word-list-term-collections/g/graphic-graphics-graphical.md
@@ -1,5 +1,6 @@
---
title: graphic, graphics, graphical - Microsoft Style Guide
+description: Describes how to user the terms "graphic", "graphics", and "graphical" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/graphics-adapter.md b/styleguide/a-z-word-list-term-collections/g/graphics-adapter.md
index 4b89a499..fb7628b8 100644
--- a/styleguide/a-z-word-list-term-collections/g/graphics-adapter.md
+++ b/styleguide/a-z-word-list-term-collections/g/graphics-adapter.md
@@ -1,5 +1,6 @@
---
title: graphics adapter - Microsoft Style Guide
+description: Describes how to use the term "graphics adapter" in Microsoft content. Use "video card" instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md b/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
index 254badd0..a9cf284d 100644
--- a/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
+++ b/styleguide/a-z-word-list-term-collections/g/gray-grayed-out.md
@@ -1,5 +1,6 @@
---
title: gray, grayed out - Microsoft Style Guide
+description: Describes how to use the terms "gray" and "grayed out" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/g/greater-better.md b/styleguide/a-z-word-list-term-collections/g/greater-better.md
index 797370a0..21d02584 100644
--- a/styleguide/a-z-word-list-term-collections/g/greater-better.md
+++ b/styleguide/a-z-word-list-term-collections/g/greater-better.md
@@ -1,5 +1,6 @@
---
title: greater, better - Microsoft Style Guide
+description: Describes how to use the terms "greater" and "better" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/greylist.md b/styleguide/a-z-word-list-term-collections/g/greylist.md
index e5f3194c..6272b648 100644
--- a/styleguide/a-z-word-list-term-collections/g/greylist.md
+++ b/styleguide/a-z-word-list-term-collections/g/greylist.md
@@ -1,5 +1,6 @@
---
title: greylist - Microsoft Style Guide
+description: Describes how to use the term "greylist" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/gridline.md b/styleguide/a-z-word-list-term-collections/g/gridline.md
index fe3a13fb..352e4181 100644
--- a/styleguide/a-z-word-list-term-collections/g/gridline.md
+++ b/styleguide/a-z-word-list-term-collections/g/gridline.md
@@ -1,5 +1,6 @@
---
title: gridline - Microsoft Style Guide
+description: Describes how to use the term "gridline" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/group-box.md b/styleguide/a-z-word-list-term-collections/g/group-box.md
index f0fcc95e..ec793de7 100644
--- a/styleguide/a-z-word-list-term-collections/g/group-box.md
+++ b/styleguide/a-z-word-list-term-collections/g/group-box.md
@@ -1,5 +1,6 @@
---
title: group box - Microsoft Style Guide
+description: Describes how to use the term "group box" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/group-newsgroup.md b/styleguide/a-z-word-list-term-collections/g/group-newsgroup.md
index 3904ee84..9dfddbca 100644
--- a/styleguide/a-z-word-list-term-collections/g/group-newsgroup.md
+++ b/styleguide/a-z-word-list-term-collections/g/group-newsgroup.md
@@ -1,5 +1,6 @@
---
title: group, newsgroup - Microsoft Style Guide
+description: Describes how to use the terms "group" and "newsgroup" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/g/grow.md b/styleguide/a-z-word-list-term-collections/g/grow.md
index 0256c306..503a61ae 100644
--- a/styleguide/a-z-word-list-term-collections/g/grow.md
+++ b/styleguide/a-z-word-list-term-collections/g/grow.md
@@ -1,5 +1,6 @@
---
title: grow - Microsoft Style Guide
+description: Describes how to use the term "grow" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hack-hacker.md b/styleguide/a-z-word-list-term-collections/h/hack-hacker.md
index 4038a081..726b331f 100644
--- a/styleguide/a-z-word-list-term-collections/h/hack-hacker.md
+++ b/styleguide/a-z-word-list-term-collections/h/hack-hacker.md
@@ -1,5 +1,6 @@
---
title: hack, hacker - Microsoft Style Guide
+description: Describes how to use the terms "hack" and "hacker" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/half-inch.md b/styleguide/a-z-word-list-term-collections/h/half-inch.md
index 25f4a391..313ac967 100644
--- a/styleguide/a-z-word-list-term-collections/h/half-inch.md
+++ b/styleguide/a-z-word-list-term-collections/h/half-inch.md
@@ -1,5 +1,6 @@
---
title: half inch - Microsoft Style Guide
+description: Describes how to use the term "half inch" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/handheld-handheld-device.md b/styleguide/a-z-word-list-term-collections/h/handheld-handheld-device.md
index 548fabd4..7609c057 100644
--- a/styleguide/a-z-word-list-term-collections/h/handheld-handheld-device.md
+++ b/styleguide/a-z-word-list-term-collections/h/handheld-handheld-device.md
@@ -1,5 +1,6 @@
---
title: handheld, handheld device - Microsoft Style Guide
+description: Describes how to use te terms "handheld" and "handheld device" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 02/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/h/handle.md b/styleguide/a-z-word-list-term-collections/h/handle.md
index 15eb467e..72611f11 100644
--- a/styleguide/a-z-word-list-term-collections/h/handle.md
+++ b/styleguide/a-z-word-list-term-collections/h/handle.md
@@ -1,5 +1,6 @@
---
title: handle - Microsoft Style Guide
+description: Describes how to use the term "handle" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/handshake.md b/styleguide/a-z-word-list-term-collections/h/handshake.md
index 26884255..5de5c547 100644
--- a/styleguide/a-z-word-list-term-collections/h/handshake.md
+++ b/styleguide/a-z-word-list-term-collections/h/handshake.md
@@ -1,5 +1,6 @@
---
title: handshake - Microsoft Style Guide
+description: Describes how to use the term "handshake" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hang.md b/styleguide/a-z-word-list-term-collections/h/hang.md
index 69a49919..fbe9e394 100644
--- a/styleguide/a-z-word-list-term-collections/h/hang.md
+++ b/styleguide/a-z-word-list-term-collections/h/hang.md
@@ -1,5 +1,6 @@
---
title: hang - Microsoft Style Guide
+description: Describes how to use the term "hang" in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding.md b/styleguide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding.md
index e7a1c12f..a83dacc8 100644
--- a/styleguide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding.md
+++ b/styleguide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding.md
@@ -1,5 +1,6 @@
---
title: hard-code, hard-coded, hard-coding - Microsoft Style Guide
+description: Describes how to use the terms "hard-code", "hard-coded", and "hard-coding" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 05/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/h/hard-copy.md b/styleguide/a-z-word-list-term-collections/h/hard-copy.md
index eab3e172..05c372ef 100644
--- a/styleguide/a-z-word-list-term-collections/h/hard-copy.md
+++ b/styleguide/a-z-word-list-term-collections/h/hard-copy.md
@@ -1,5 +1,6 @@
---
title: hard copy - Microsoft Style Guide
+description: Describes how to use the term "hard copy" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hard-drive.md b/styleguide/a-z-word-list-term-collections/h/hard-drive.md
index 079ef240..d36d1875 100644
--- a/styleguide/a-z-word-list-term-collections/h/hard-drive.md
+++ b/styleguide/a-z-word-list-term-collections/h/hard-drive.md
@@ -1,5 +1,6 @@
---
title: hard drive - Microsoft Style Guide
+description: Describes how to use the term "hard drive" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hard-of-hearing.md b/styleguide/a-z-word-list-term-collections/h/hard-of-hearing.md
index 2a4c8549..43680bff 100644
--- a/styleguide/a-z-word-list-term-collections/h/hard-of-hearing.md
+++ b/styleguide/a-z-word-list-term-collections/h/hard-of-hearing.md
@@ -1,5 +1,6 @@
---
title: hard-of-hearing - Microsoft Style Guide
+description: Describes how to use the term "hard-of-hearing" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hardwired.md b/styleguide/a-z-word-list-term-collections/h/hardwired.md
index fbad3c6c..f8017fc5 100644
--- a/styleguide/a-z-word-list-term-collections/h/hardwired.md
+++ b/styleguide/a-z-word-list-term-collections/h/hardwired.md
@@ -1,5 +1,6 @@
---
title: hardwired - Microsoft Style Guide
+description: Describes how to use the term "hardwired" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hdmi.md b/styleguide/a-z-word-list-term-collections/h/hdmi.md
index 1c24691e..9bd6ab39 100644
--- a/styleguide/a-z-word-list-term-collections/h/hdmi.md
+++ b/styleguide/a-z-word-list-term-collections/h/hdmi.md
@@ -1,5 +1,6 @@
---
title: HDMI (High-Definition Multimedia Interface) - Microsoft Style Guide
+description: Describes how to use the term "HDMI" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/he-she.md b/styleguide/a-z-word-list-term-collections/h/he-she.md
index 32da0ef1..ad6a7912 100644
--- a/styleguide/a-z-word-list-term-collections/h/he-she.md
+++ b/styleguide/a-z-word-list-term-collections/h/he-she.md
@@ -1,5 +1,6 @@
---
title: he/she - Microsoft Style Guide
+description: Describes how to use the terms "he" and "she" in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 09/13/2019
diff --git a/styleguide/a-z-word-list-term-collections/h/header.md b/styleguide/a-z-word-list-term-collections/h/header.md
index e130c5e9..27379047 100644
--- a/styleguide/a-z-word-list-term-collections/h/header.md
+++ b/styleguide/a-z-word-list-term-collections/h/header.md
@@ -1,5 +1,6 @@
---
title: header - Microsoft Style Guide
+description: Describes how to use te term "header" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/heading.md b/styleguide/a-z-word-list-term-collections/h/heading.md
index 88c128d3..547908dd 100644
--- a/styleguide/a-z-word-list-term-collections/h/heading.md
+++ b/styleguide/a-z-word-list-term-collections/h/heading.md
@@ -1,5 +1,6 @@
---
title: heading - Microsoft Style Guide
+description: Describes how to use the term "heading" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hearing-impaired.md b/styleguide/a-z-word-list-term-collections/h/hearing-impaired.md
index db2d115b..e32da292 100644
--- a/styleguide/a-z-word-list-term-collections/h/hearing-impaired.md
+++ b/styleguide/a-z-word-list-term-collections/h/hearing-impaired.md
@@ -1,5 +1,6 @@
---
title: hearing-impaired - Microsoft Style Guide
+description: Describes how to use the term "hearing-impaired" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/help.md b/styleguide/a-z-word-list-term-collections/h/help.md
index a905a984..1f57c88f 100644
--- a/styleguide/a-z-word-list-term-collections/h/help.md
+++ b/styleguide/a-z-word-list-term-collections/h/help.md
@@ -1,5 +1,6 @@
---
title: Help - Microsoft Style Guide
+description: Describes how to use the term "help" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hexadecimal.md b/styleguide/a-z-word-list-term-collections/h/hexadecimal.md
index 9d8400dc..e07fee2a 100644
--- a/styleguide/a-z-word-list-term-collections/h/hexadecimal.md
+++ b/styleguide/a-z-word-list-term-collections/h/hexadecimal.md
@@ -1,5 +1,6 @@
---
title: hexadecimal - Microsoft Style Guide
+description: Describes how to use the term "hexadecimal" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From dd9267545e6657372c7850d8300201b5a93f4829 Mon Sep 17 00:00:00 2001
From: annmariehitchcock <106630431+annmariehitchcock@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:14:00 -0700
Subject: [PATCH 218/486] added descriptions set 1
---
styleguide/a-z-word-list-term-collections/l/labeled-labeling.md | 1 +
styleguide/a-z-word-list-term-collections/l/laptop.md | 1 +
styleguide/a-z-word-list-term-collections/l/later.md | 1 +
3 files changed, 3 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md b/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
index 90c18c92..2b11f997 100644
--- a/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
+++ b/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
@@ -1,5 +1,6 @@
---
title: labeled, labeling - Microsoft Style Guide
+description: Guidelines for using the labeled and labeling in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/laptop.md b/styleguide/a-z-word-list-term-collections/l/laptop.md
index c7507cf3..cd9202d4 100644
--- a/styleguide/a-z-word-list-term-collections/l/laptop.md
+++ b/styleguide/a-z-word-list-term-collections/l/laptop.md
@@ -1,5 +1,6 @@
---
title: laptop - Microsoft Style Guide
+description: This article provides a link to learn how to use the term laptop in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/later.md b/styleguide/a-z-word-list-term-collections/l/later.md
index 8100ad07..5287a4ec 100644
--- a/styleguide/a-z-word-list-term-collections/l/later.md
+++ b/styleguide/a-z-word-list-term-collections/l/later.md
@@ -1,5 +1,6 @@
---
title: later - Microsoft Style Guide
+description: This article provides a link to learn how to use the term later in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From ec5c6240cd0096322de7b547cd2d0a0be3ddd34a Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:25:20 -0700
Subject: [PATCH 219/486] BULK VALIDATION missing descriptions 2
---
styleguide/a-z-word-list-term-collections/h/hierarchical-menu.md | 1 +
.../h/high-level-language-compiler.md | 1 +
styleguide/a-z-word-list-term-collections/h/high-quality.md | 1 +
styleguide/a-z-word-list-term-collections/h/high-resolution.md | 1 +
styleguide/a-z-word-list-term-collections/h/higher.md | 1 +
styleguide/a-z-word-list-term-collections/h/hint.md | 1 +
styleguide/a-z-word-list-term-collections/h/hit.md | 1 +
styleguide/a-z-word-list-term-collections/h/home-directory.md | 1 +
styleguide/a-z-word-list-term-collections/h/home-home-page.md | 1 +
styleguide/a-z-word-list-term-collections/h/honeypot.md | 1 +
styleguide/a-z-word-list-term-collections/h/host-name.md | 1 +
styleguide/a-z-word-list-term-collections/h/hosted-service.md | 1 +
styleguide/a-z-word-list-term-collections/h/hosting-provider.md | 1 +
styleguide/a-z-word-list-term-collections/h/hot-key.md | 1 +
styleguide/a-z-word-list-term-collections/h/hot-link.md | 1 +
styleguide/a-z-word-list-term-collections/h/hot-spot-hotspot.md | 1 +
.../a-z-word-list-term-collections/h/hover-over-hovering.md | 1 +
styleguide/a-z-word-list-term-collections/h/how-how-to.md | 1 +
styleguide/a-z-word-list-term-collections/h/html.md | 1 +
styleguide/a-z-word-list-term-collections/h/http-https.md | 1 +
styleguide/a-z-word-list-term-collections/h/hybrid-cloud.md | 1 +
styleguide/a-z-word-list-term-collections/h/hyperlink.md | 1 +
styleguide/a-z-word-list-term-collections/i/iconize.md | 1 +
styleguide/a-z-word-list-term-collections/i/ie.md | 1 +
.../a-z-word-list-term-collections/i/if-vs-whether-vs-when.md | 1 +
styleguide/a-z-word-list-term-collections/i/illegal.md | 1 +
styleguide/a-z-word-list-term-collections/i/image-map.md | 1 +
styleguide/a-z-word-list-term-collections/i/imbed.md | 1 +
styleguide/a-z-word-list-term-collections/i/impact.md | 1 +
.../a-z-word-list-term-collections/i/inactive-inactive-state.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/h/hierarchical-menu.md b/styleguide/a-z-word-list-term-collections/h/hierarchical-menu.md
index a0c68b8c..d75e9ea4 100644
--- a/styleguide/a-z-word-list-term-collections/h/hierarchical-menu.md
+++ b/styleguide/a-z-word-list-term-collections/h/hierarchical-menu.md
@@ -1,5 +1,6 @@
---
title: hierarchical menu - Microsoft Style Guide
+description: Describes how to use the term "hierarchical menu" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/high-level-language-compiler.md b/styleguide/a-z-word-list-term-collections/h/high-level-language-compiler.md
index 12986deb..8eef209d 100644
--- a/styleguide/a-z-word-list-term-collections/h/high-level-language-compiler.md
+++ b/styleguide/a-z-word-list-term-collections/h/high-level-language-compiler.md
@@ -1,5 +1,6 @@
---
title: high-level-language compiler - Microsoft Style Guide
+description: Describes how to use the term "high-level-language compiler" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/high-quality.md b/styleguide/a-z-word-list-term-collections/h/high-quality.md
index 7ba9c50f..2877653e 100644
--- a/styleguide/a-z-word-list-term-collections/h/high-quality.md
+++ b/styleguide/a-z-word-list-term-collections/h/high-quality.md
@@ -1,5 +1,6 @@
---
title: high-quality - Microsoft Style Guide
+description: Describes how to use the term "high-quality" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/high-resolution.md b/styleguide/a-z-word-list-term-collections/h/high-resolution.md
index 14a4f4b2..b0ae5035 100644
--- a/styleguide/a-z-word-list-term-collections/h/high-resolution.md
+++ b/styleguide/a-z-word-list-term-collections/h/high-resolution.md
@@ -1,5 +1,6 @@
---
title: high-resolution - Microsoft Style Guide
+description: Describes how to use the term "high-resolution" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/higher.md b/styleguide/a-z-word-list-term-collections/h/higher.md
index 6f987217..516b892f 100644
--- a/styleguide/a-z-word-list-term-collections/h/higher.md
+++ b/styleguide/a-z-word-list-term-collections/h/higher.md
@@ -1,5 +1,6 @@
---
title: higher - Microsoft Style Guide
+description: Describes how to use the term "higher" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hint.md b/styleguide/a-z-word-list-term-collections/h/hint.md
index d211c869..64ef4bbe 100644
--- a/styleguide/a-z-word-list-term-collections/h/hint.md
+++ b/styleguide/a-z-word-list-term-collections/h/hint.md
@@ -1,5 +1,6 @@
---
title: hint - Microsoft Style Guide
+description: Describes how to use the term "hint" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hit.md b/styleguide/a-z-word-list-term-collections/h/hit.md
index ee838398..89c75dab 100644
--- a/styleguide/a-z-word-list-term-collections/h/hit.md
+++ b/styleguide/a-z-word-list-term-collections/h/hit.md
@@ -1,5 +1,6 @@
---
title: hit - Microsoft Style Guide
+description: Describes how to use the term "hit" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/home-directory.md b/styleguide/a-z-word-list-term-collections/h/home-directory.md
index 66623dca..2b937a05 100644
--- a/styleguide/a-z-word-list-term-collections/h/home-directory.md
+++ b/styleguide/a-z-word-list-term-collections/h/home-directory.md
@@ -1,5 +1,6 @@
---
title: home directory - Microsoft Style Guide
+description: Describes how to use the term "home directory" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/home-home-page.md b/styleguide/a-z-word-list-term-collections/h/home-home-page.md
index 2a353caf..6608cbda 100644
--- a/styleguide/a-z-word-list-term-collections/h/home-home-page.md
+++ b/styleguide/a-z-word-list-term-collections/h/home-home-page.md
@@ -1,5 +1,6 @@
---
title: home, home page - Microsoft Style Guide
+description: Describes how to use the terms "home" and "home page" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/honeypot.md b/styleguide/a-z-word-list-term-collections/h/honeypot.md
index 9f0b76bf..13ac3681 100644
--- a/styleguide/a-z-word-list-term-collections/h/honeypot.md
+++ b/styleguide/a-z-word-list-term-collections/h/honeypot.md
@@ -1,5 +1,6 @@
---
title: honeypot - Microsoft Style Guide
+description: Describes how to use the term "honeypot" in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/host-name.md b/styleguide/a-z-word-list-term-collections/h/host-name.md
index 5bec3298..b75be7da 100644
--- a/styleguide/a-z-word-list-term-collections/h/host-name.md
+++ b/styleguide/a-z-word-list-term-collections/h/host-name.md
@@ -1,5 +1,6 @@
---
title: host name - Microsoft Style Guide
+description: "Describes how to use the term "host name" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hosted-service.md b/styleguide/a-z-word-list-term-collections/h/hosted-service.md
index 23921e8a..1c72d66a 100644
--- a/styleguide/a-z-word-list-term-collections/h/hosted-service.md
+++ b/styleguide/a-z-word-list-term-collections/h/hosted-service.md
@@ -1,5 +1,6 @@
---
title: hosted service - Microsoft Style Guide
+descripition: Describes how to use the term "hosted service" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hosting-provider.md b/styleguide/a-z-word-list-term-collections/h/hosting-provider.md
index 08367ec7..6bfc376b 100644
--- a/styleguide/a-z-word-list-term-collections/h/hosting-provider.md
+++ b/styleguide/a-z-word-list-term-collections/h/hosting-provider.md
@@ -1,5 +1,6 @@
---
title: hosting provider - Microsoft Style Guide
+description: Describes how to use the term "hosting provider" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hot-key.md b/styleguide/a-z-word-list-term-collections/h/hot-key.md
index 10d95be8..71f4f2fc 100644
--- a/styleguide/a-z-word-list-term-collections/h/hot-key.md
+++ b/styleguide/a-z-word-list-term-collections/h/hot-key.md
@@ -1,5 +1,6 @@
---
title: hot key - Microsoft Style Guide
+description: Describes how to use the term "hot key" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hot-link.md b/styleguide/a-z-word-list-term-collections/h/hot-link.md
index a3e01999..a2039c69 100644
--- a/styleguide/a-z-word-list-term-collections/h/hot-link.md
+++ b/styleguide/a-z-word-list-term-collections/h/hot-link.md
@@ -1,5 +1,6 @@
---
title: hot link - Microsoft Style Guide
+description: Describes how to use the term "hot link" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hot-spot-hotspot.md b/styleguide/a-z-word-list-term-collections/h/hot-spot-hotspot.md
index 686c786e..dc764cd7 100644
--- a/styleguide/a-z-word-list-term-collections/h/hot-spot-hotspot.md
+++ b/styleguide/a-z-word-list-term-collections/h/hot-spot-hotspot.md
@@ -1,5 +1,6 @@
---
title: hot spot, hotspot - Microsoft Style Guide
+description: Describes how to use the terms "hot spot" and "hotspot" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hover-over-hovering.md b/styleguide/a-z-word-list-term-collections/h/hover-over-hovering.md
index 253319c1..744c553b 100644
--- a/styleguide/a-z-word-list-term-collections/h/hover-over-hovering.md
+++ b/styleguide/a-z-word-list-term-collections/h/hover-over-hovering.md
@@ -1,5 +1,6 @@
---
title: hover over, hovering - Microsoft Style Guide
+description: Describes how to use the terms "hover over" and "hovering" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 11/27/2016
diff --git a/styleguide/a-z-word-list-term-collections/h/how-how-to.md b/styleguide/a-z-word-list-term-collections/h/how-how-to.md
index 42a6359e..fc93da9a 100644
--- a/styleguide/a-z-word-list-term-collections/h/how-how-to.md
+++ b/styleguide/a-z-word-list-term-collections/h/how-how-to.md
@@ -1,5 +1,6 @@
---
title: how to, how-to - Microsoft Style Guide
+description: Describes how to use the terms "how to" and "how-to" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/html.md b/styleguide/a-z-word-list-term-collections/h/html.md
index 55382f77..d5e88a3e 100644
--- a/styleguide/a-z-word-list-term-collections/h/html.md
+++ b/styleguide/a-z-word-list-term-collections/h/html.md
@@ -1,5 +1,6 @@
---
title: HTML - Microsoft Style Guide
+description: Describes how to use the term "HTML" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/http-https.md b/styleguide/a-z-word-list-term-collections/h/http-https.md
index fd535ca5..7b2347de 100644
--- a/styleguide/a-z-word-list-term-collections/h/http-https.md
+++ b/styleguide/a-z-word-list-term-collections/h/http-https.md
@@ -1,5 +1,6 @@
---
title: HTTP, HTTPS - Microsoft Style Guide
+description: Describes how to use the terms "HTTP" and "HTTPS" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 06/26/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hybrid-cloud.md b/styleguide/a-z-word-list-term-collections/h/hybrid-cloud.md
index 0d29ec67..4c552a8d 100644
--- a/styleguide/a-z-word-list-term-collections/h/hybrid-cloud.md
+++ b/styleguide/a-z-word-list-term-collections/h/hybrid-cloud.md
@@ -1,5 +1,6 @@
---
title: hybrid cloud - Microsoft Style Guide
+description: Describes how to use the term "hybrid cloud" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/h/hyperlink.md b/styleguide/a-z-word-list-term-collections/h/hyperlink.md
index 204cc17e..a5ccc18c 100644
--- a/styleguide/a-z-word-list-term-collections/h/hyperlink.md
+++ b/styleguide/a-z-word-list-term-collections/h/hyperlink.md
@@ -1,5 +1,6 @@
---
title: hyperlink - Microsoft Style Guide
+description: Describes how to use the term "hyperlink" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/iconize.md b/styleguide/a-z-word-list-term-collections/i/iconize.md
index 3f11566c..45f02dec 100644
--- a/styleguide/a-z-word-list-term-collections/i/iconize.md
+++ b/styleguide/a-z-word-list-term-collections/i/iconize.md
@@ -1,5 +1,6 @@
---
title: iconize - Microsoft Style Guide
+description: Describes how to use the term "iconize" in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/ie.md b/styleguide/a-z-word-list-term-collections/i/ie.md
index 7e60cc80..e5b38333 100644
--- a/styleguide/a-z-word-list-term-collections/i/ie.md
+++ b/styleguide/a-z-word-list-term-collections/i/ie.md
@@ -1,5 +1,6 @@
---
title: i.e. - Microsoft Style Guide
+description: Describes how to use the term "i.e." in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/if-vs-whether-vs-when.md b/styleguide/a-z-word-list-term-collections/i/if-vs-whether-vs-when.md
index 35646b33..9c7346bf 100644
--- a/styleguide/a-z-word-list-term-collections/i/if-vs-whether-vs-when.md
+++ b/styleguide/a-z-word-list-term-collections/i/if-vs-whether-vs-when.md
@@ -1,5 +1,6 @@
---
title: if vs. whether vs. when - Microsoft Style Guide
+description: Describes how to decide between the use of terms "if", "whether", and "when" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/illegal.md b/styleguide/a-z-word-list-term-collections/i/illegal.md
index a59be847..70ee2b2e 100644
--- a/styleguide/a-z-word-list-term-collections/i/illegal.md
+++ b/styleguide/a-z-word-list-term-collections/i/illegal.md
@@ -1,5 +1,6 @@
---
title: illegal - Microsoft Style Guide
+description: Describes the use of the term "illegal" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/image-map.md b/styleguide/a-z-word-list-term-collections/i/image-map.md
index 9467f712..f6da5d31 100644
--- a/styleguide/a-z-word-list-term-collections/i/image-map.md
+++ b/styleguide/a-z-word-list-term-collections/i/image-map.md
@@ -1,5 +1,6 @@
---
title: image map - Microsoft Style Guide
+description: Describes the use of the term "image map" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/imbed.md b/styleguide/a-z-word-list-term-collections/i/imbed.md
index 2f83a165..f151a245 100644
--- a/styleguide/a-z-word-list-term-collections/i/imbed.md
+++ b/styleguide/a-z-word-list-term-collections/i/imbed.md
@@ -1,5 +1,6 @@
---
title: imbed - Microsoft Style Guide
+description: Describes the use of the term "imbed" in Microsoft content. Don't use.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/impact.md b/styleguide/a-z-word-list-term-collections/i/impact.md
index 574fe9c0..786902d7 100644
--- a/styleguide/a-z-word-list-term-collections/i/impact.md
+++ b/styleguide/a-z-word-list-term-collections/i/impact.md
@@ -1,5 +1,6 @@
---
title: impact - Microsoft Style Guide
+description: Describes the use of the term "impact" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/inactive-inactive-state.md b/styleguide/a-z-word-list-term-collections/i/inactive-inactive-state.md
index 10cf1243..63fd55dd 100644
--- a/styleguide/a-z-word-list-term-collections/i/inactive-inactive-state.md
+++ b/styleguide/a-z-word-list-term-collections/i/inactive-inactive-state.md
@@ -1,5 +1,6 @@
---
title: inactive, inactive state - Microsoft Style Guide
+description: Describes how to use the terms "inactive" and "inactive state" in microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 0e2d8085f0e356c967deea1f0d58ffe333c18a9b Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:31:45 -0700
Subject: [PATCH 220/486] fix
---
styleguide/a-z-word-list-term-collections/h/hosted-service.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/h/hosted-service.md b/styleguide/a-z-word-list-term-collections/h/hosted-service.md
index 1c72d66a..ccb8bc6c 100644
--- a/styleguide/a-z-word-list-term-collections/h/hosted-service.md
+++ b/styleguide/a-z-word-list-term-collections/h/hosted-service.md
@@ -1,6 +1,6 @@
---
title: hosted service - Microsoft Style Guide
-descripition: Describes how to use the term "hosted service" in Microsoft content.
+description: Describes how to use the term "hosted service" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 61eb39ea7524017d24c46985fb499e7fdececfb9 Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:38:57 -0700
Subject: [PATCH 221/486] fix
---
styleguide/a-z-word-list-term-collections/h/host-name.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/h/host-name.md b/styleguide/a-z-word-list-term-collections/h/host-name.md
index b75be7da..bc408925 100644
--- a/styleguide/a-z-word-list-term-collections/h/host-name.md
+++ b/styleguide/a-z-word-list-term-collections/h/host-name.md
@@ -1,6 +1,6 @@
---
title: host name - Microsoft Style Guide
-description: "Describes how to use the term "host name" in Microsoft content.
+description: Describes how to use the term "host name" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 340029b5de4041ad2fdc72118975a6d9fe94f8db Mon Sep 17 00:00:00 2001
From: annmariehitchcock <106630431+annmariehitchcock@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:42:52 -0700
Subject: [PATCH 222/486] added descriptions set 2
---
styleguide/a-z-word-list-term-collections/l/launch.md | 1 +
.../a-z-word-list-term-collections/l/lay-out-laid-out-layout.md | 1 +
styleguide/a-z-word-list-term-collections/l/leading.md | 1 +
styleguide/a-z-word-list-term-collections/l/leave.md | 1 +
.../a-z-word-list-term-collections/l/left-align-left-aligned.md | 1 +
5 files changed, 5 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/l/launch.md b/styleguide/a-z-word-list-term-collections/l/launch.md
index 1944b2a6..9d80d66e 100644
--- a/styleguide/a-z-word-list-term-collections/l/launch.md
+++ b/styleguide/a-z-word-list-term-collections/l/launch.md
@@ -1,5 +1,6 @@
---
title: launch - Microsoft Style Guide
+description: This article provides a link to learn how to use the term launch in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 04/30/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lay-out-laid-out-layout.md b/styleguide/a-z-word-list-term-collections/l/lay-out-laid-out-layout.md
index 6c312c40..ac9d5175 100644
--- a/styleguide/a-z-word-list-term-collections/l/lay-out-laid-out-layout.md
+++ b/styleguide/a-z-word-list-term-collections/l/lay-out-laid-out-layout.md
@@ -1,5 +1,6 @@
---
title: lay out, laid out, layout - Microsoft Style Guide
+description: Guidelines for using the terms lay out, laid out and layout in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/leading.md b/styleguide/a-z-word-list-term-collections/l/leading.md
index f709a563..db4861a3 100644
--- a/styleguide/a-z-word-list-term-collections/l/leading.md
+++ b/styleguide/a-z-word-list-term-collections/l/leading.md
@@ -1,5 +1,6 @@
---
title: leading - Microsoft Style Guide
+description: Guidelines for using the term leading in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/leave.md b/styleguide/a-z-word-list-term-collections/l/leave.md
index 7eb37cf5..07550751 100644
--- a/styleguide/a-z-word-list-term-collections/l/leave.md
+++ b/styleguide/a-z-word-list-term-collections/l/leave.md
@@ -1,5 +1,6 @@
---
title: leave - Microsoft Style Guide
+description: This article provides a link to learn how to use the term leave in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/left-align-left-aligned.md b/styleguide/a-z-word-list-term-collections/l/left-align-left-aligned.md
index ab70bec1..44ec206b 100644
--- a/styleguide/a-z-word-list-term-collections/l/left-align-left-aligned.md
+++ b/styleguide/a-z-word-list-term-collections/l/left-align-left-aligned.md
@@ -1,5 +1,6 @@
---
title: left align, left-aligned - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrases left align and left-aligned in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 8733032dfb67d2fd15142979874010551125c9db Mon Sep 17 00:00:00 2001
From: annmariehitchcock <106630431+annmariehitchcock@users.noreply.github.com>
Date: Fri, 3 Jun 2022 12:57:16 -0700
Subject: [PATCH 223/486] added descriptions set 3
---
.../l/left-justify-left-justified.md | 1 +
.../a-z-word-list-term-collections/l/left-leftmost-left-hand.md | 1 +
styleguide/a-z-word-list-term-collections/l/left-mouse-button.md | 1 +
styleguide/a-z-word-list-term-collections/l/legacy.md | 1 +
styleguide/a-z-word-list-term-collections/l/legal.md | 1 +
.../a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md | 1 +
6 files changed, 6 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/l/left-justify-left-justified.md b/styleguide/a-z-word-list-term-collections/l/left-justify-left-justified.md
index d6898148..285a8a98 100644
--- a/styleguide/a-z-word-list-term-collections/l/left-justify-left-justified.md
+++ b/styleguide/a-z-word-list-term-collections/l/left-justify-left-justified.md
@@ -1,5 +1,6 @@
---
title: left justify, left-justified - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrases left justify and left-justified in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/left-leftmost-left-hand.md b/styleguide/a-z-word-list-term-collections/l/left-leftmost-left-hand.md
index a84c945e..39ba4cad 100644
--- a/styleguide/a-z-word-list-term-collections/l/left-leftmost-left-hand.md
+++ b/styleguide/a-z-word-list-term-collections/l/left-leftmost-left-hand.md
@@ -1,5 +1,6 @@
---
title: left, leftmost, left-hand - Microsoft Style Guide
+description: Guidelines for using the terms left, leftmost and left-hand in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/left-mouse-button.md b/styleguide/a-z-word-list-term-collections/l/left-mouse-button.md
index df4ecb2a..64cbbdba 100644
--- a/styleguide/a-z-word-list-term-collections/l/left-mouse-button.md
+++ b/styleguide/a-z-word-list-term-collections/l/left-mouse-button.md
@@ -1,5 +1,6 @@
---
title: left mouse button - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrase left mouse button in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/legacy.md b/styleguide/a-z-word-list-term-collections/l/legacy.md
index a8cc6836..9fabe9b5 100644
--- a/styleguide/a-z-word-list-term-collections/l/legacy.md
+++ b/styleguide/a-z-word-list-term-collections/l/legacy.md
@@ -1,5 +1,6 @@
---
title: legacy - Microsoft Style Guide
+description: Guidelines for using the term legacy in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/legal.md b/styleguide/a-z-word-list-term-collections/l/legal.md
index c4224f43..d9c5d4c2 100644
--- a/styleguide/a-z-word-list-term-collections/l/legal.md
+++ b/styleguide/a-z-word-list-term-collections/l/legal.md
@@ -1,5 +1,6 @@
---
title: legal - Microsoft Style Guide
+description: Guidelines for using the term legal in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md b/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
index 30f34efc..3674bd44 100644
--- a/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
+++ b/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
@@ -1,5 +1,6 @@
---
title: less vs. fewer vs. under - Microsoft Style Guide
+description: Guidelines for using the terms less vs. fewer vs. under in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 8d20485f56d6f6e5c8d5a54657b0eaa4d1754146 Mon Sep 17 00:00:00 2001
From: annmariehitchcock <106630431+annmariehitchcock@users.noreply.github.com>
Date: Fri, 3 Jun 2022 13:10:29 -0700
Subject: [PATCH 224/486] added descriptions set 4
---
styleguide/a-z-word-list-term-collections/l/let-lets.md | 1 +
styleguide/a-z-word-list-term-collections/l/leverage.md | 1 +
styleguide/a-z-word-list-term-collections/l/license-terms.md | 1 +
styleguide/a-z-word-list-term-collections/l/like.md | 1 +
4 files changed, 4 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/l/let-lets.md b/styleguide/a-z-word-list-term-collections/l/let-lets.md
index 2be63bbd..9687c365 100644
--- a/styleguide/a-z-word-list-term-collections/l/let-lets.md
+++ b/styleguide/a-z-word-list-term-collections/l/let-lets.md
@@ -1,5 +1,6 @@
---
title: let, lets - Microsoft Style Guide
+description: Guidelines for using the terms let and lets in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/leverage.md b/styleguide/a-z-word-list-term-collections/l/leverage.md
index a129036e..ab337816 100644
--- a/styleguide/a-z-word-list-term-collections/l/leverage.md
+++ b/styleguide/a-z-word-list-term-collections/l/leverage.md
@@ -1,5 +1,6 @@
---
title: leverage - Microsoft Style Guide
+description: Guidelines for using the term leverage in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/license-terms.md b/styleguide/a-z-word-list-term-collections/l/license-terms.md
index 4a5fa785..00303d60 100644
--- a/styleguide/a-z-word-list-term-collections/l/license-terms.md
+++ b/styleguide/a-z-word-list-term-collections/l/license-terms.md
@@ -1,5 +1,6 @@
---
title: license terms - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrase license terms in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/like.md b/styleguide/a-z-word-list-term-collections/l/like.md
index 403c9da4..61c8496b 100644
--- a/styleguide/a-z-word-list-term-collections/l/like.md
+++ b/styleguide/a-z-word-list-term-collections/l/like.md
@@ -1,5 +1,6 @@
---
title: \-like - Microsoft Style Guide
+description: This article provides a link to learn how to use hyphenation for terms ending with -like in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From d811e06737f4fa6269145a3092e8353b27f290b8 Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 13:30:16 -0700
Subject: [PATCH 225/486] BULK VALIDATION missing descriptions 3
---
styleguide/a-z-word-list-term-collections/i/inbound.md | 1 +
styleguide/a-z-word-list-term-collections/i/incoming-outgoing.md | 1 +
styleguide/a-z-word-list-term-collections/i/increment.md | 1 +
styleguide/a-z-word-list-term-collections/i/indent-outdent.md | 1 +
.../a-z-word-list-term-collections/i/index-indexes-indices.md | 1 +
styleguide/a-z-word-list-term-collections/i/info.md | 1 +
.../i/infrastructure-as-a-service.md | 1 +
styleguide/a-z-word-list-term-collections/i/initialize.md | 1 +
styleguide/a-z-word-list-term-collections/i/initiate.md | 1 +
styleguide/a-z-word-list-term-collections/i/inline.md | 1 +
styleguide/a-z-word-list-term-collections/i/input-output.md | 1 +
styleguide/a-z-word-list-term-collections/i/input.md | 1 +
styleguide/a-z-word-list-term-collections/i/insecure.md | 1 +
styleguide/a-z-word-list-term-collections/i/inside.md | 1 +
styleguide/a-z-word-list-term-collections/i/install.md | 1 +
.../a-z-word-list-term-collections/i/instant-message-im.md | 1 +
styleguide/a-z-word-list-term-collections/i/instantiate.md | 1 +
.../a-z-word-list-term-collections/i/insure-assure-ensure.md | 1 +
.../i/intelligence-intelligent-technology.md | 1 +
styleguide/a-z-word-list-term-collections/i/interface.md | 1 +
.../i/internet-connection-sharing.md | 1 +
styleguide/a-z-word-list-term-collections/i/internet-explorer.md | 1 +
.../i/internet-intranet-extranet.md | 1 +
.../a-z-word-list-term-collections/i/internet-of-things-iot.md | 1 +
.../i/internet-service-provider.md | 1 +
styleguide/a-z-word-list-term-collections/i/invalid-not-valid.md | 1 +
styleguide/a-z-word-list-term-collections/i/invite.md | 1 +
styleguide/a-z-word-list-term-collections/i/invoke.md | 1 +
styleguide/a-z-word-list-term-collections/i/ip-address.md | 1 +
styleguide/a-z-word-list-term-collections/i/issue.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/i/inbound.md b/styleguide/a-z-word-list-term-collections/i/inbound.md
index 534785a9..c765c957 100644
--- a/styleguide/a-z-word-list-term-collections/i/inbound.md
+++ b/styleguide/a-z-word-list-term-collections/i/inbound.md
@@ -1,5 +1,6 @@
---
title: inbound - Microsoft Style Guide
+description: Describes how to use the term "inbound" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/incoming-outgoing.md b/styleguide/a-z-word-list-term-collections/i/incoming-outgoing.md
index 24693ef6..228048ba 100644
--- a/styleguide/a-z-word-list-term-collections/i/incoming-outgoing.md
+++ b/styleguide/a-z-word-list-term-collections/i/incoming-outgoing.md
@@ -1,5 +1,6 @@
---
title: incoming, outgoing - Microsoft Style Guide
+description: Describes how to use the terms "incoming" and "outgoing" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/increment.md b/styleguide/a-z-word-list-term-collections/i/increment.md
index 1122b439..eb4f14c4 100644
--- a/styleguide/a-z-word-list-term-collections/i/increment.md
+++ b/styleguide/a-z-word-list-term-collections/i/increment.md
@@ -1,5 +1,6 @@
---
title: increment - Microsoft Style Guide
+description: Describes how to use the term "increment" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/indent-outdent.md b/styleguide/a-z-word-list-term-collections/i/indent-outdent.md
index 04a271eb..bebb044b 100644
--- a/styleguide/a-z-word-list-term-collections/i/indent-outdent.md
+++ b/styleguide/a-z-word-list-term-collections/i/indent-outdent.md
@@ -1,5 +1,6 @@
---
title: indent, outdent - Microsoft Style Guide
+description: Describes how to use the terms "indent" and "outdent" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/index-indexes-indices.md b/styleguide/a-z-word-list-term-collections/i/index-indexes-indices.md
index 858f99a5..060d08c1 100644
--- a/styleguide/a-z-word-list-term-collections/i/index-indexes-indices.md
+++ b/styleguide/a-z-word-list-term-collections/i/index-indexes-indices.md
@@ -1,5 +1,6 @@
---
title: index, indexes, indices - Microsoft Style Guide
+description: Describes how to use the terms "index", "indexes", and "indices" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/info.md b/styleguide/a-z-word-list-term-collections/i/info.md
index afc71c2c..ba1f607a 100644
--- a/styleguide/a-z-word-list-term-collections/i/info.md
+++ b/styleguide/a-z-word-list-term-collections/i/info.md
@@ -1,5 +1,6 @@
---
title: info - Microsoft Style Guide
+description: Describes how to use the term "info" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/infrastructure-as-a-service.md b/styleguide/a-z-word-list-term-collections/i/infrastructure-as-a-service.md
index 8069a61e..65adfeaa 100644
--- a/styleguide/a-z-word-list-term-collections/i/infrastructure-as-a-service.md
+++ b/styleguide/a-z-word-list-term-collections/i/infrastructure-as-a-service.md
@@ -1,5 +1,6 @@
---
title: infrastructure as a service (IaaS) - Microsoft Style Guide
+description: Describes how to use the term "infrastructure as a service (IaaS)" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/initialize.md b/styleguide/a-z-word-list-term-collections/i/initialize.md
index 23ce6029..fda16816 100644
--- a/styleguide/a-z-word-list-term-collections/i/initialize.md
+++ b/styleguide/a-z-word-list-term-collections/i/initialize.md
@@ -1,5 +1,6 @@
---
title: initialize - Microsoft Style Guide
+description: Describes how to use the term "initialize" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/initiate.md b/styleguide/a-z-word-list-term-collections/i/initiate.md
index 1dc22814..419da92d 100644
--- a/styleguide/a-z-word-list-term-collections/i/initiate.md
+++ b/styleguide/a-z-word-list-term-collections/i/initiate.md
@@ -1,5 +1,6 @@
---
title: initiate - Microsoft Style Guide
+description: Describes how to use the term "initiate" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/inline.md b/styleguide/a-z-word-list-term-collections/i/inline.md
index d72df904..4438b737 100644
--- a/styleguide/a-z-word-list-term-collections/i/inline.md
+++ b/styleguide/a-z-word-list-term-collections/i/inline.md
@@ -1,5 +1,6 @@
---
title: inline - Microsoft Style Guide
+description: Describes how to use the term "inline" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/input-output.md b/styleguide/a-z-word-list-term-collections/i/input-output.md
index 4e93f4bc..ad3a6e53 100644
--- a/styleguide/a-z-word-list-term-collections/i/input-output.md
+++ b/styleguide/a-z-word-list-term-collections/i/input-output.md
@@ -1,5 +1,6 @@
---
title: input/output, I/O, input/output control - Microsoft Style Guide
+description: Describes how to use the terms "input/output", "I/O", and "input/output control" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/input.md b/styleguide/a-z-word-list-term-collections/i/input.md
index ae218aa2..6b1d45b4 100644
--- a/styleguide/a-z-word-list-term-collections/i/input.md
+++ b/styleguide/a-z-word-list-term-collections/i/input.md
@@ -1,5 +1,6 @@
---
title: input - Microsoft Style Guide
+description: Describes how to use the term "input" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 02/21/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/insecure.md b/styleguide/a-z-word-list-term-collections/i/insecure.md
index 683a6e9d..db4b5dc3 100644
--- a/styleguide/a-z-word-list-term-collections/i/insecure.md
+++ b/styleguide/a-z-word-list-term-collections/i/insecure.md
@@ -1,5 +1,6 @@
---
title: insecure - Microsoft Style Guide
+description: Describes how to use the term "insecure" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/inside.md b/styleguide/a-z-word-list-term-collections/i/inside.md
index afbf8881..558e4770 100644
--- a/styleguide/a-z-word-list-term-collections/i/inside.md
+++ b/styleguide/a-z-word-list-term-collections/i/inside.md
@@ -1,5 +1,6 @@
---
title: inside - Microsoft Style Guide
+description: Describes how to use the term "inside" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/install.md b/styleguide/a-z-word-list-term-collections/i/install.md
index c292e625..d93df1af 100644
--- a/styleguide/a-z-word-list-term-collections/i/install.md
+++ b/styleguide/a-z-word-list-term-collections/i/install.md
@@ -1,5 +1,6 @@
---
title: install - Microsoft Style Guide
+description: Describes how to use the term "install" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/instant-message-im.md b/styleguide/a-z-word-list-term-collections/i/instant-message-im.md
index 0b54b5f2..1146ef51 100644
--- a/styleguide/a-z-word-list-term-collections/i/instant-message-im.md
+++ b/styleguide/a-z-word-list-term-collections/i/instant-message-im.md
@@ -1,5 +1,6 @@
---
title: instant message, IM - Microsoft Style Guide
+description: Describes how to use the terms "instant message" and "IM" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/instantiate.md b/styleguide/a-z-word-list-term-collections/i/instantiate.md
index 24fb371a..4c69cbe3 100644
--- a/styleguide/a-z-word-list-term-collections/i/instantiate.md
+++ b/styleguide/a-z-word-list-term-collections/i/instantiate.md
@@ -1,5 +1,6 @@
---
title: instantiate - Microsoft Style Guide
+description: Describes how to use the term "instantiate" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/insure-assure-ensure.md b/styleguide/a-z-word-list-term-collections/i/insure-assure-ensure.md
index 33014fbb..1936a224 100644
--- a/styleguide/a-z-word-list-term-collections/i/insure-assure-ensure.md
+++ b/styleguide/a-z-word-list-term-collections/i/insure-assure-ensure.md
@@ -1,5 +1,6 @@
---
title: insure, assure, ensure - Microsoft Style Guide
+description: Describes how to use the terms "insure", "assure", and "ensure" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/intelligence-intelligent-technology.md b/styleguide/a-z-word-list-term-collections/i/intelligence-intelligent-technology.md
index 806b29e5..beb415fc 100644
--- a/styleguide/a-z-word-list-term-collections/i/intelligence-intelligent-technology.md
+++ b/styleguide/a-z-word-list-term-collections/i/intelligence-intelligent-technology.md
@@ -1,5 +1,6 @@
---
title: intelligence, intelligent technology - Microsoft Style Guide
+description: Describes how to use the terms "intelligent" and "intelligent technology" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/interface.md b/styleguide/a-z-word-list-term-collections/i/interface.md
index e983c67a..57ff8ce4 100644
--- a/styleguide/a-z-word-list-term-collections/i/interface.md
+++ b/styleguide/a-z-word-list-term-collections/i/interface.md
@@ -1,5 +1,6 @@
---
title: interface - Microsoft Style Guide
+description: Describes how to use the term "interface" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/internet-connection-sharing.md b/styleguide/a-z-word-list-term-collections/i/internet-connection-sharing.md
index c3d69062..9eff54e3 100644
--- a/styleguide/a-z-word-list-term-collections/i/internet-connection-sharing.md
+++ b/styleguide/a-z-word-list-term-collections/i/internet-connection-sharing.md
@@ -1,5 +1,6 @@
---
title: Internet Connection Sharing - Microsoft Style Guide
+description: Describes how to use the term "Internet Connection Sharing" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/internet-explorer.md b/styleguide/a-z-word-list-term-collections/i/internet-explorer.md
index ccbde2d5..49760415 100644
--- a/styleguide/a-z-word-list-term-collections/i/internet-explorer.md
+++ b/styleguide/a-z-word-list-term-collections/i/internet-explorer.md
@@ -1,5 +1,6 @@
---
title: Internet Explorer - Microsoft Style Guide
+description: Describes how to use the term "Internet Explorer" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/internet-intranet-extranet.md b/styleguide/a-z-word-list-term-collections/i/internet-intranet-extranet.md
index 88d60625..6d1c03c4 100644
--- a/styleguide/a-z-word-list-term-collections/i/internet-intranet-extranet.md
+++ b/styleguide/a-z-word-list-term-collections/i/internet-intranet-extranet.md
@@ -1,5 +1,6 @@
---
title: internet, intranet, extranet - Microsoft Style Guide
+description: Describes how to use the terms "internet", "intranet", and "extranet" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/internet-of-things-iot.md b/styleguide/a-z-word-list-term-collections/i/internet-of-things-iot.md
index e7310efe..ff078619 100644
--- a/styleguide/a-z-word-list-term-collections/i/internet-of-things-iot.md
+++ b/styleguide/a-z-word-list-term-collections/i/internet-of-things-iot.md
@@ -1,5 +1,6 @@
---
title: Internet of Things (IoT) - Microsoft Style Guide
+description: Describes how to use the term "Internet of Things (IOT)" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 1/18/2019
diff --git a/styleguide/a-z-word-list-term-collections/i/internet-service-provider.md b/styleguide/a-z-word-list-term-collections/i/internet-service-provider.md
index c8c9d078..ced33f6b 100644
--- a/styleguide/a-z-word-list-term-collections/i/internet-service-provider.md
+++ b/styleguide/a-z-word-list-term-collections/i/internet-service-provider.md
@@ -1,5 +1,6 @@
---
title: internet service provider (ISP) - Microsoft Style Guide
+description: Describes how to use the term "Internet service provider (ISP)" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/invalid-not-valid.md b/styleguide/a-z-word-list-term-collections/i/invalid-not-valid.md
index 5d39a82e..5cfe6769 100644
--- a/styleguide/a-z-word-list-term-collections/i/invalid-not-valid.md
+++ b/styleguide/a-z-word-list-term-collections/i/invalid-not-valid.md
@@ -1,5 +1,6 @@
---
title: invalid, not valid - Microsoft Style Guide
+description: Describes how to use the terms "invalid" and "not valid" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/invite.md b/styleguide/a-z-word-list-term-collections/i/invite.md
index e8e1347c..48d0a7cf 100644
--- a/styleguide/a-z-word-list-term-collections/i/invite.md
+++ b/styleguide/a-z-word-list-term-collections/i/invite.md
@@ -1,5 +1,6 @@
---
title: invite - Microsoft Style Guide
+description: Describes how to use the term "invite" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 04/30/2021
diff --git a/styleguide/a-z-word-list-term-collections/i/invoke.md b/styleguide/a-z-word-list-term-collections/i/invoke.md
index 21875248..c2956150 100644
--- a/styleguide/a-z-word-list-term-collections/i/invoke.md
+++ b/styleguide/a-z-word-list-term-collections/i/invoke.md
@@ -1,5 +1,6 @@
---
title: invoke - Microsoft Style Guide
+description: Describes how to use the term "invoke" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/ip-address.md b/styleguide/a-z-word-list-term-collections/i/ip-address.md
index 96581948..10d537e1 100644
--- a/styleguide/a-z-word-list-term-collections/i/ip-address.md
+++ b/styleguide/a-z-word-list-term-collections/i/ip-address.md
@@ -1,5 +1,6 @@
---
title: IP address - Microsoft Style Guide
+description: Describes how to use the term "IP address" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/issue.md b/styleguide/a-z-word-list-term-collections/i/issue.md
index 299ef97e..04ec6d8b 100644
--- a/styleguide/a-z-word-list-term-collections/i/issue.md
+++ b/styleguide/a-z-word-list-term-collections/i/issue.md
@@ -1,5 +1,6 @@
---
title: issue - Microsoft Style Guide
+description: Describes how to use the term "issue" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 988f7825006386668d72904c5b418059aa034289 Mon Sep 17 00:00:00 2001
From: annmariehitchcock <106630431+annmariehitchcock@users.noreply.github.com>
Date: Fri, 3 Jun 2022 13:39:30 -0700
Subject: [PATCH 226/486] added descriptions set 5
---
styleguide/a-z-word-list-term-collections/l/labeled-labeling.md | 2 +-
styleguide/a-z-word-list-term-collections/l/like.md | 2 +-
styleguide/a-z-word-list-term-collections/l/line-of-business.md | 1 +
styleguide/a-z-word-list-term-collections/l/line.md | 1 +
styleguide/a-z-word-list-term-collections/l/link.md | 1 +
styleguide/a-z-word-list-term-collections/l/list-box.md | 1 +
styleguide/a-z-word-list-term-collections/l/load.md | 1 +
styleguide/a-z-word-list-term-collections/l/lock-up.md | 1 +
styleguide/a-z-word-list-term-collections/l/lock.md | 1 +
styleguide/a-z-word-list-term-collections/l/log-on-log-off.md | 1 +
styleguide/a-z-word-list-term-collections/l/low-resolution.md | 1 +
.../a-z-word-list-term-collections/l/lower-left-lower-right.md | 1 +
styleguide/a-z-word-list-term-collections/l/lower.md | 1 +
styleguide/a-z-word-list-term-collections/l/lowercase.md | 1 +
14 files changed, 14 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md b/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
index 2b11f997..63ee5441 100644
--- a/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
+++ b/styleguide/a-z-word-list-term-collections/l/labeled-labeling.md
@@ -1,6 +1,6 @@
---
title: labeled, labeling - Microsoft Style Guide
-description: Guidelines for using the labeled and labeling in Microsoft documents.
+description: Guidelines for using the terms labeled and labeling in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/like.md b/styleguide/a-z-word-list-term-collections/l/like.md
index 61c8496b..67f8548a 100644
--- a/styleguide/a-z-word-list-term-collections/l/like.md
+++ b/styleguide/a-z-word-list-term-collections/l/like.md
@@ -1,6 +1,6 @@
---
title: \-like - Microsoft Style Guide
-description: This article provides a link to learn how to use hyphenation for terms ending with -like in Microsoft documents.
+description: This article provides a link to learn how to use hyphenation for terms ending with \-like in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/line-of-business.md b/styleguide/a-z-word-list-term-collections/l/line-of-business.md
index be36ea76..af43af20 100644
--- a/styleguide/a-z-word-list-term-collections/l/line-of-business.md
+++ b/styleguide/a-z-word-list-term-collections/l/line-of-business.md
@@ -1,5 +1,6 @@
---
title: line of business, line-of-business - Microsoft Style Guide
+description: Guidelines for using the phrases line of business and line-of-business in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/line.md b/styleguide/a-z-word-list-term-collections/l/line.md
index 366c94a8..54e20db6 100644
--- a/styleguide/a-z-word-list-term-collections/l/line.md
+++ b/styleguide/a-z-word-list-term-collections/l/line.md
@@ -1,5 +1,6 @@
---
title: line - Microsoft Style Guide
+description: Guidelines for using the term line in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/link.md b/styleguide/a-z-word-list-term-collections/l/link.md
index d8f14690..1eb04d59 100644
--- a/styleguide/a-z-word-list-term-collections/l/link.md
+++ b/styleguide/a-z-word-list-term-collections/l/link.md
@@ -1,5 +1,6 @@
---
title: link - Microsoft Style Guide
+description: This article provides a link to learn how to use the term link in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/list-box.md b/styleguide/a-z-word-list-term-collections/l/list-box.md
index 1992a32a..b4ebac63 100644
--- a/styleguide/a-z-word-list-term-collections/l/list-box.md
+++ b/styleguide/a-z-word-list-term-collections/l/list-box.md
@@ -1,5 +1,6 @@
---
title: list box - Microsoft Style Guide
+description: This article provides a link to learn how to use the term list box in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/load.md b/styleguide/a-z-word-list-term-collections/l/load.md
index ad4b6d0b..cdabfa7c 100644
--- a/styleguide/a-z-word-list-term-collections/l/load.md
+++ b/styleguide/a-z-word-list-term-collections/l/load.md
@@ -1,5 +1,6 @@
---
title: load - Microsoft Style Guide
+description: This article provides a link to learn how to use the term load in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lock-up.md b/styleguide/a-z-word-list-term-collections/l/lock-up.md
index 536ab638..8f35ebd8 100644
--- a/styleguide/a-z-word-list-term-collections/l/lock-up.md
+++ b/styleguide/a-z-word-list-term-collections/l/lock-up.md
@@ -1,5 +1,6 @@
---
title: lock up - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrase lock up in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lock.md b/styleguide/a-z-word-list-term-collections/l/lock.md
index 11205318..bd870268 100644
--- a/styleguide/a-z-word-list-term-collections/l/lock.md
+++ b/styleguide/a-z-word-list-term-collections/l/lock.md
@@ -1,5 +1,6 @@
---
title: lock - Microsoft Style Guide
+description: This article provides a link to learn how to use the term lock in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/log-on-log-off.md b/styleguide/a-z-word-list-term-collections/l/log-on-log-off.md
index b05c21c3..ff962e67 100644
--- a/styleguide/a-z-word-list-term-collections/l/log-on-log-off.md
+++ b/styleguide/a-z-word-list-term-collections/l/log-on-log-off.md
@@ -1,5 +1,6 @@
---
title: log on, log off - Microsoft Style Guide
+description: This article provides a link to learn how to use the phrases log on and log off in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/low-resolution.md b/styleguide/a-z-word-list-term-collections/l/low-resolution.md
index 02552f56..ac616b24 100644
--- a/styleguide/a-z-word-list-term-collections/l/low-resolution.md
+++ b/styleguide/a-z-word-list-term-collections/l/low-resolution.md
@@ -1,5 +1,6 @@
---
title: low-resolution - Microsoft Style Guide
+description: Guidelines for using the term low-resolution in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lower-left-lower-right.md b/styleguide/a-z-word-list-term-collections/l/lower-left-lower-right.md
index 275b6f9c..9aee7437 100644
--- a/styleguide/a-z-word-list-term-collections/l/lower-left-lower-right.md
+++ b/styleguide/a-z-word-list-term-collections/l/lower-left-lower-right.md
@@ -1,5 +1,6 @@
---
title: lower left, lower-left, lower right, lower-right - Microsoft Style Guide
+description: Guidelines for using the phrases lower left, lower-left, lower right and lower-ri in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lower.md b/styleguide/a-z-word-list-term-collections/l/lower.md
index 77cbc2cc..4d8dc101 100644
--- a/styleguide/a-z-word-list-term-collections/l/lower.md
+++ b/styleguide/a-z-word-list-term-collections/l/lower.md
@@ -1,5 +1,6 @@
---
title: lower - Microsoft Style Guide
+description: This article provides a link to learn how to use the term lower in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/l/lowercase.md b/styleguide/a-z-word-list-term-collections/l/lowercase.md
index b944c2c1..7504dbb7 100644
--- a/styleguide/a-z-word-list-term-collections/l/lowercase.md
+++ b/styleguide/a-z-word-list-term-collections/l/lowercase.md
@@ -1,5 +1,6 @@
---
title: lowercase - Microsoft Style Guide
+description: Guidelines for using the term lowercase in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 6baa03c8150a9ae978567bef28af7628bbfa36ad Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Fri, 3 Jun 2022 14:07:37 -0700
Subject: [PATCH 227/486] BULK VALIDATION missing descriptions 4
---
.../a-z-word-list-term-collections/i/it-pro-it-professional.md | 1 +
styleguide/a-z-word-list-term-collections/i/italic.md | 1 +
styleguide/a-z-word-list-term-collections/i/its-vs-its.md | 1 +
.../a-z-word-list-term-collections/j/java-jscript-javascript.md | 1 +
styleguide/a-z-word-list-term-collections/j/join.md | 1 +
styleguide/a-z-word-list-term-collections/j/joystick.md | 1 +
styleguide/a-z-word-list-term-collections/j/jump.md | 1 +
styleguide/a-z-word-list-term-collections/j/justify-justified.md | 1 +
styleguide/a-z-word-list-term-collections/k/kerberos-protocol.md | 1 +
styleguide/a-z-word-list-term-collections/k/key-combination.md | 1 +
styleguide/a-z-word-list-term-collections/k/key-sequence.md | 1 +
styleguide/a-z-word-list-term-collections/k/keyboard-shortcut.md | 1 +
styleguide/a-z-word-list-term-collections/k/keypad.md | 1 +
.../a-z-word-list-term-collections/k/keypress-keystroke.md | 1 +
styleguide/a-z-word-list-term-collections/k/kilobit.md | 1 +
.../a-z-word-list-term-collections/k/kilobits-per-second.md | 1 +
styleguide/a-z-word-list-term-collections/k/kilobyte.md | 1 +
.../a-z-word-list-term-collections/k/kilobytes-per-second.md | 1 +
styleguide/a-z-word-list-term-collections/k/kilohertz.md | 1 +
styleguide/a-z-word-list-term-collections/k/knowledge-base.md | 1 +
20 files changed, 20 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/i/it-pro-it-professional.md b/styleguide/a-z-word-list-term-collections/i/it-pro-it-professional.md
index 69e9d42c..e9cf855d 100644
--- a/styleguide/a-z-word-list-term-collections/i/it-pro-it-professional.md
+++ b/styleguide/a-z-word-list-term-collections/i/it-pro-it-professional.md
@@ -1,5 +1,6 @@
---
title: IT pro, IT professional - Microsoft Style Guide
+description: Describes how to use the terms "IT pro" and "IT professional" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/i/italic.md b/styleguide/a-z-word-list-term-collections/i/italic.md
index 6b3a8921..5b971bc6 100644
--- a/styleguide/a-z-word-list-term-collections/i/italic.md
+++ b/styleguide/a-z-word-list-term-collections/i/italic.md
@@ -1,5 +1,6 @@
---
title: italic - Microsoft Style Guide
+description: Describes how to use the term "italic" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/i/its-vs-its.md b/styleguide/a-z-word-list-term-collections/i/its-vs-its.md
index 9b701ab5..12b7ce99 100644
--- a/styleguide/a-z-word-list-term-collections/i/its-vs-its.md
+++ b/styleguide/a-z-word-list-term-collections/i/its-vs-its.md
@@ -1,5 +1,6 @@
---
title: its vs. it's - Microsoft Style Guide
+description: Describes how to use the terms "its" and "it's" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 03/12/2018
diff --git a/styleguide/a-z-word-list-term-collections/j/java-jscript-javascript.md b/styleguide/a-z-word-list-term-collections/j/java-jscript-javascript.md
index f54bec66..633f5021 100644
--- a/styleguide/a-z-word-list-term-collections/j/java-jscript-javascript.md
+++ b/styleguide/a-z-word-list-term-collections/j/java-jscript-javascript.md
@@ -1,5 +1,6 @@
---
title: Java, JScript, JavaScript - Microsoft Style Guide
+description: Describes how to use the terms "Java", "Jscript", and "Javascript" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/j/join.md b/styleguide/a-z-word-list-term-collections/j/join.md
index 092bdc79..04c0b487 100644
--- a/styleguide/a-z-word-list-term-collections/j/join.md
+++ b/styleguide/a-z-word-list-term-collections/j/join.md
@@ -1,5 +1,6 @@
---
title: join - Microsoft Style Guide
+description: Describes how to use the word "join" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/j/joystick.md b/styleguide/a-z-word-list-term-collections/j/joystick.md
index ee193380..d09c4016 100644
--- a/styleguide/a-z-word-list-term-collections/j/joystick.md
+++ b/styleguide/a-z-word-list-term-collections/j/joystick.md
@@ -1,5 +1,6 @@
---
title: joystick - Microsoft Style Guide
+description: Describes how to use the term "joystick" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/j/jump.md b/styleguide/a-z-word-list-term-collections/j/jump.md
index d228877c..f721f5ee 100644
--- a/styleguide/a-z-word-list-term-collections/j/jump.md
+++ b/styleguide/a-z-word-list-term-collections/j/jump.md
@@ -1,5 +1,6 @@
---
title: jump - Microsoft Style Guide
+description: Describes how to use the term "jump" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/j/justify-justified.md b/styleguide/a-z-word-list-term-collections/j/justify-justified.md
index 6e3aba4f..0f37ed4c 100644
--- a/styleguide/a-z-word-list-term-collections/j/justify-justified.md
+++ b/styleguide/a-z-word-list-term-collections/j/justify-justified.md
@@ -1,5 +1,6 @@
---
title: justify, justified - Microsoft Style Guide
+description: Describes how to use the terms "justify" and "justified" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/kerberos-protocol.md b/styleguide/a-z-word-list-term-collections/k/kerberos-protocol.md
index 52016fc8..59e9257c 100644
--- a/styleguide/a-z-word-list-term-collections/k/kerberos-protocol.md
+++ b/styleguide/a-z-word-list-term-collections/k/kerberos-protocol.md
@@ -1,5 +1,6 @@
---
title: Kerberos protocol - Microsoft Style Guide
+description: Describes how to use the term "Kerberos protocol" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/key-combination.md b/styleguide/a-z-word-list-term-collections/k/key-combination.md
index 89d951f8..7070fe68 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-combination.md
+++ b/styleguide/a-z-word-list-term-collections/k/key-combination.md
@@ -1,5 +1,6 @@
---
title: key combination - Microsoft Style Guide
+description: Describes how to use the term "key combination" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/key-sequence.md b/styleguide/a-z-word-list-term-collections/k/key-sequence.md
index 11cef586..69699405 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-sequence.md
+++ b/styleguide/a-z-word-list-term-collections/k/key-sequence.md
@@ -1,5 +1,6 @@
---
title: key sequence - Microsoft Style Guide
+description: Describes how to use the term "key sequence" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/keyboard-shortcut.md b/styleguide/a-z-word-list-term-collections/k/keyboard-shortcut.md
index ee382ca5..284621d3 100644
--- a/styleguide/a-z-word-list-term-collections/k/keyboard-shortcut.md
+++ b/styleguide/a-z-word-list-term-collections/k/keyboard-shortcut.md
@@ -1,5 +1,6 @@
---
title: keyboard shortcut - Microsoft Style Guide
+description: Describes how to use the term "keyboard shortcut" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/keypad.md b/styleguide/a-z-word-list-term-collections/k/keypad.md
index 6adafd51..3450e3f6 100644
--- a/styleguide/a-z-word-list-term-collections/k/keypad.md
+++ b/styleguide/a-z-word-list-term-collections/k/keypad.md
@@ -1,5 +1,6 @@
---
title: keypad - Microsoft Style Guide
+description: Describes how to use the term "keypad" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/keypress-keystroke.md b/styleguide/a-z-word-list-term-collections/k/keypress-keystroke.md
index 4036eea6..318fdf02 100644
--- a/styleguide/a-z-word-list-term-collections/k/keypress-keystroke.md
+++ b/styleguide/a-z-word-list-term-collections/k/keypress-keystroke.md
@@ -1,5 +1,6 @@
---
title: keypress, keystroke - Microsoft Style Guide
+description: Describes how to use the terms "keypress" and "keystroke" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/kilobit.md b/styleguide/a-z-word-list-term-collections/k/kilobit.md
index c1414bf7..c374e4b9 100644
--- a/styleguide/a-z-word-list-term-collections/k/kilobit.md
+++ b/styleguide/a-z-word-list-term-collections/k/kilobit.md
@@ -1,5 +1,6 @@
---
title: kilobit, Kbit - Microsoft Style Guide
+description: Describes how to use the terms "kilobit" and "Kbit" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/kilobits-per-second.md b/styleguide/a-z-word-list-term-collections/k/kilobits-per-second.md
index 2773f92f..c05dc05b 100644
--- a/styleguide/a-z-word-list-term-collections/k/kilobits-per-second.md
+++ b/styleguide/a-z-word-list-term-collections/k/kilobits-per-second.md
@@ -1,5 +1,6 @@
---
title: kilobits per second, Kbps - Microsoft Style Guide
+description: Describes how to use the terms "kilobits per second" and "Kbps" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/kilobyte.md b/styleguide/a-z-word-list-term-collections/k/kilobyte.md
index b2f80b2c..fa9ec333 100644
--- a/styleguide/a-z-word-list-term-collections/k/kilobyte.md
+++ b/styleguide/a-z-word-list-term-collections/k/kilobyte.md
@@ -1,5 +1,6 @@
---
title: kilobyte, KB, K, K byte, Kbyte - Microsoft Style Guide
+description: Describes how to use the terms "kilobyte", "KB", "K", "K byte", and "Kbyte" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 09/18/2019
diff --git a/styleguide/a-z-word-list-term-collections/k/kilobytes-per-second.md b/styleguide/a-z-word-list-term-collections/k/kilobytes-per-second.md
index 6577b0d9..737b374a 100644
--- a/styleguide/a-z-word-list-term-collections/k/kilobytes-per-second.md
+++ b/styleguide/a-z-word-list-term-collections/k/kilobytes-per-second.md
@@ -1,5 +1,6 @@
---
title: kilobytes per second, KBps - Microsoft Style Guide
+description: Describes how to use the terms "kilobytes per second" and "KBps" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/kilohertz.md b/styleguide/a-z-word-list-term-collections/k/kilohertz.md
index 65fa649b..3e848bdc 100644
--- a/styleguide/a-z-word-list-term-collections/k/kilohertz.md
+++ b/styleguide/a-z-word-list-term-collections/k/kilohertz.md
@@ -1,5 +1,6 @@
---
title: kilohertz, KHz - Microsoft Style Guide
+description: Describes how to use the terms "kilohertz" and "KHz" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/k/knowledge-base.md b/styleguide/a-z-word-list-term-collections/k/knowledge-base.md
index 69ade391..1e04f897 100644
--- a/styleguide/a-z-word-list-term-collections/k/knowledge-base.md
+++ b/styleguide/a-z-word-list-term-collections/k/knowledge-base.md
@@ -1,5 +1,6 @@
---
title: knowledge base, Knowledge Base - Microsoft Style Guide
+description: Describes how to use the terms "knowledge base" and "Knowledge Base" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 2839b4a7243f3450416c9d8b5788c8899178036a Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Fri, 3 Jun 2022 17:40:53 -0500
Subject: [PATCH 228/486] added meta data
---
styleguide/a-z-word-list-term-collections/w/wellbeing.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/where.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/while.md | 4 +++-
.../a-z-word-list-term-collections/w/white-hat-hacker.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/white-paper.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/white-space.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/who-vs-that.md | 2 ++
styleguide/a-z-word-list-term-collections/w/wi-fi.md | 2 ++
.../a-z-word-list-term-collections/w/wildcard-character.md | 2 ++
styleguide/a-z-word-list-term-collections/w/window.md | 2 ++
.../w/windows-7-windows-8-windows-10.md | 2 ++
.../a-z-word-list-term-collections/w/windows-explorer.md | 2 ++
.../a-z-word-list-term-collections/w/windows-windows-based.md | 2 ++
styleguide/a-z-word-list-term-collections/w/wireframe.md | 4 +++-
styleguide/a-z-word-list-term-collections/w/wireless.md | 2 ++
styleguide/a-z-word-list-term-collections/w/wizard.md | 4 +++-
.../a-z-word-list-term-collections/w/word-processing.md | 2 ++
.../a-z-word-list-term-collections/w/wordwrap-wordwrapping.md | 2 ++
.../a-z-word-list-term-collections/w/work-area-workspace.md | 2 ++
styleguide/a-z-word-list-term-collections/w/work-style.md | 2 ++
styleguide/a-z-word-list-term-collections/w/workgroup.md | 2 ++
styleguide/a-z-word-list-term-collections/w/working-memory.md | 2 ++
styleguide/a-z-word-list-term-collections/w/workstation.md | 2 ++
styleguide/a-z-word-list-term-collections/w/workstream.md | 2 ++
.../w/worldwide-vs-international.md | 2 ++
25 files changed, 58 insertions(+), 8 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/w/wellbeing.md b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
index 03134938..0acc75aa 100644
--- a/styleguide/a-z-word-list-term-collections/w/wellbeing.md
+++ b/styleguide/a-z-word-list-term-collections/w/wellbeing.md
@@ -1,9 +1,11 @@
---
title: wellbeing - Microsoft Style Guide
-description: Statement that demonstrates the correct spelling and context of the word "wellbeing" in an example sentence.
+description: Instructs not to use the term "well-being," but to use "wellbeing" with an example sentence.
author: pallep
ms.author: pallep
ms.date: 05/31/2021
+ms.topic: article
+ms.prod: non-product-specific
---
# wellbeing
diff --git a/styleguide/a-z-word-list-term-collections/w/where.md b/styleguide/a-z-word-list-term-collections/w/where.md
index 79a0c39b..ef1eccec 100644
--- a/styleguide/a-z-word-list-term-collections/w/where.md
+++ b/styleguide/a-z-word-list-term-collections/w/where.md
@@ -1,9 +1,11 @@
---
title: where - Microsoft Style Guide
-description: Statement that uses "where" to introduce a list, as in code or formulas, to define the meaning of elements such as variables or symbols with an example.
+description: Demonstrates to use "where" to introduce a list, as in code or formulas, to define the meaning of elements such as variables or symbols with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# where
diff --git a/styleguide/a-z-word-list-term-collections/w/while.md b/styleguide/a-z-word-list-term-collections/w/while.md
index a188b942..38ebf28f 100644
--- a/styleguide/a-z-word-list-term-collections/w/while.md
+++ b/styleguide/a-z-word-list-term-collections/w/while.md
@@ -1,9 +1,11 @@
---
title: while - Microsoft Style Guide
-description: Statement that uses the word "while" to refer to something occurring in time. Don't use as a synonym for although, whereas, on the contrary, or in spite of.
+description: Demonstrates using the word "while" to refer to something occurring in time. Don't use as a synonym for although, whereas, on the contrary, or in spite of.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# while
diff --git a/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md b/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
index d57cf3c3..5b127a3b 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-hat-hacker.md
@@ -1,9 +1,11 @@
---
title: white hat hacker - Microsoft Style Guide
-description: Statement that instructs to see the Security term collection for "white hat hacker."
+description: Instructs to see the Security term collection for "white hat hacker."
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# white hat hacker
diff --git a/styleguide/a-z-word-list-term-collections/w/white-paper.md b/styleguide/a-z-word-list-term-collections/w/white-paper.md
index adccfd06..10733e15 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-paper.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-paper.md
@@ -1,9 +1,11 @@
---
title: white paper - Microsoft Style Guide
-description: Statement that shows the term "white paper" is two words.
+description: States the term "white paper" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# white paper
diff --git a/styleguide/a-z-word-list-term-collections/w/white-space.md b/styleguide/a-z-word-list-term-collections/w/white-space.md
index b12c71e4..19f746f6 100644
--- a/styleguide/a-z-word-list-term-collections/w/white-space.md
+++ b/styleguide/a-z-word-list-term-collections/w/white-space.md
@@ -1,9 +1,11 @@
---
title: white space - Microsoft Style Guide
-description: Statement that states the term "white space" is two words.
+description: States the term "white space" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# white space
diff --git a/styleguide/a-z-word-list-term-collections/w/who-vs-that.md b/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
index 40779c3e..65f3cdfd 100644
--- a/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
+++ b/styleguide/a-z-word-list-term-collections/w/who-vs-that.md
@@ -4,6 +4,8 @@ description: Demonstrates the terms "who vs. that" by using "who" instead of "th
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# who vs. that
diff --git a/styleguide/a-z-word-list-term-collections/w/wi-fi.md b/styleguide/a-z-word-list-term-collections/w/wi-fi.md
index 8e1537fa..8caa9e6b 100644
--- a/styleguide/a-z-word-list-term-collections/w/wi-fi.md
+++ b/styleguide/a-z-word-list-term-collections/w/wi-fi.md
@@ -4,6 +4,8 @@ description: Explains to use a general phrase instead of Wi-Fi, such as wireless
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# Wi-Fi
diff --git a/styleguide/a-z-word-list-term-collections/w/wildcard-character.md b/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
index 2babe12c..b1e3812a 100644
--- a/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
+++ b/styleguide/a-z-word-list-term-collections/w/wildcard-character.md
@@ -4,6 +4,8 @@ description: Describes how to use the "wildcard character," not just wildcard, t
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# wildcard character
diff --git a/styleguide/a-z-word-list-term-collections/w/window.md b/styleguide/a-z-word-list-term-collections/w/window.md
index ec09027d..31428128 100644
--- a/styleguide/a-z-word-list-term-collections/w/window.md
+++ b/styleguide/a-z-word-list-term-collections/w/window.md
@@ -4,6 +4,8 @@ description: Instructs not to use the term "window" as a verb.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# window
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md b/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
index 71581f20..95ae6360 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md
@@ -4,6 +4,8 @@ description: Instructs to always use the entire name when referring to Windows 7
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# Windows 7, Windows 8, Windows 10
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-explorer.md b/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
index 855c9933..3966899f 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-explorer.md
@@ -4,6 +4,8 @@ description: Instructs to not use "Windows Explorer" and to see File Explorer fo
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# Windows Explorer
diff --git a/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md b/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
index 05d350c6..2f028822 100644
--- a/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
+++ b/styleguide/a-z-word-list-term-collections/w/windows-windows-based.md
@@ -4,6 +4,8 @@ description: Instructs to use Windows on "Windows, Windows-based", as a modifier
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# Windows, Windows-based
diff --git a/styleguide/a-z-word-list-term-collections/w/wireframe.md b/styleguide/a-z-word-list-term-collections/w/wireframe.md
index 94a3d05f..37fe8d11 100644
--- a/styleguide/a-z-word-list-term-collections/w/wireframe.md
+++ b/styleguide/a-z-word-list-term-collections/w/wireframe.md
@@ -1,9 +1,11 @@
---
title: wireframe - Microsoft Style Guide
-description: This states that the term "wireframe" is one word.
+description: Instructs that the term "wireframe" is one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# wireframe
diff --git a/styleguide/a-z-word-list-term-collections/w/wireless.md b/styleguide/a-z-word-list-term-collections/w/wireless.md
index 8bb098fb..a7870d2a 100644
--- a/styleguide/a-z-word-list-term-collections/w/wireless.md
+++ b/styleguide/a-z-word-list-term-collections/w/wireless.md
@@ -4,6 +4,8 @@ description: Discusses to avoid talking about wireless technology to general use
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# wireless
diff --git a/styleguide/a-z-word-list-term-collections/w/wizard.md b/styleguide/a-z-word-list-term-collections/w/wizard.md
index 06702aef..6237bca4 100644
--- a/styleguide/a-z-word-list-term-collections/w/wizard.md
+++ b/styleguide/a-z-word-list-term-collections/w/wizard.md
@@ -1,9 +1,11 @@
---
title: wizard - Microsoft Style Guide
-description: Instructs not to use the term "wizard," in general, unless it appears in the UI, but to talk about what the customer needs to do to accomplish the task.
+description: Instructs to not use the term "wizard, in general, unless it appears in the UI. Instead, talk about what the customer needs to do to accomplish the task.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# wizard
diff --git a/styleguide/a-z-word-list-term-collections/w/word-processing.md b/styleguide/a-z-word-list-term-collections/w/word-processing.md
index 0120cd00..4637ffb3 100644
--- a/styleguide/a-z-word-list-term-collections/w/word-processing.md
+++ b/styleguide/a-z-word-list-term-collections/w/word-processing.md
@@ -4,6 +4,8 @@ description: Instructs to use "word processor" or "word processing" as a noun an
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# word processing, word-processing
diff --git a/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md b/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
index 98c28dd2..28d10938 100644
--- a/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
+++ b/styleguide/a-z-word-list-term-collections/w/wordwrap-wordwrapping.md
@@ -4,6 +4,8 @@ description: Instructs to not use the terms "wordwrap" and "wordwrapping."
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# wordwrap, wordwrapping
diff --git a/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md b/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
index 1a187e20..f48a35ca 100644
--- a/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
+++ b/styleguide/a-z-word-list-term-collections/w/work-area-workspace.md
@@ -4,6 +4,8 @@ description: States that "Work area" is two words and "Workspace" is one word, a
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# work area, workspace
diff --git a/styleguide/a-z-word-list-term-collections/w/work-style.md b/styleguide/a-z-word-list-term-collections/w/work-style.md
index 3430979e..8ee14fb2 100644
--- a/styleguide/a-z-word-list-term-collections/w/work-style.md
+++ b/styleguide/a-z-word-list-term-collections/w/work-style.md
@@ -4,6 +4,8 @@ description: States that the terms "work style" is two words.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# work style
diff --git a/styleguide/a-z-word-list-term-collections/w/workgroup.md b/styleguide/a-z-word-list-term-collections/w/workgroup.md
index a6560e2f..55235d34 100644
--- a/styleguide/a-z-word-list-term-collections/w/workgroup.md
+++ b/styleguide/a-z-word-list-term-collections/w/workgroup.md
@@ -4,6 +4,8 @@ description: States that the term "workgroup" is one word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# workgroup
diff --git a/styleguide/a-z-word-list-term-collections/w/working-memory.md b/styleguide/a-z-word-list-term-collections/w/working-memory.md
index 9a456e99..5f852736 100644
--- a/styleguide/a-z-word-list-term-collections/w/working-memory.md
+++ b/styleguide/a-z-word-list-term-collections/w/working-memory.md
@@ -4,6 +4,8 @@ description: Instructs not to use the terms "working memory," but to use "availa
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# working memory
diff --git a/styleguide/a-z-word-list-term-collections/w/workstation.md b/styleguide/a-z-word-list-term-collections/w/workstation.md
index cf57436b..4f4bd8b4 100644
--- a/styleguide/a-z-word-list-term-collections/w/workstation.md
+++ b/styleguide/a-z-word-list-term-collections/w/workstation.md
@@ -4,6 +4,8 @@ description: States that the term "workstation" is one word and instructs to avo
author: pallep
ms.author: pallep
ms.date: 01/19/2018
+ms.topic: article
+ms.prod: non-product-specific
---
# workstation
diff --git a/styleguide/a-z-word-list-term-collections/w/workstream.md b/styleguide/a-z-word-list-term-collections/w/workstream.md
index ff5df0ff..b3feeb74 100644
--- a/styleguide/a-z-word-list-term-collections/w/workstream.md
+++ b/styleguide/a-z-word-list-term-collections/w/workstream.md
@@ -4,6 +4,8 @@ description: Instructs to use the term "workstream" as one word without a hyphen
author: pallep
ms.author: pallep
ms.date: 05/31/2021
+ms.topic: article
+ms.prod: non-product-specific
---
# workstream
diff --git a/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md b/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
index a8e0c58c..85e103ba 100644
--- a/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
+++ b/styleguide/a-z-word-list-term-collections/w/worldwide-vs-international.md
@@ -4,6 +4,8 @@ description: Instructs to use "worldwide" regarding "worldwide vs. international
author: pallep
ms.author: pallep
ms.date: 11/24/2020
+ms.topic: article
+ms.prod: non-product-specific
---
# worldwide vs. international
From 9d4738c0cc5b9221c9b633ecba3071729eeffa9c Mon Sep 17 00:00:00 2001
From: Dan Mabee <40476441+damabe@users.noreply.github.com>
Date: Fri, 3 Jun 2022 18:37:44 -0700
Subject: [PATCH 229/486] Build validation fixes
---
.../a-z-word-list-term-collections/q/quality-high-quality.md | 1 +
styleguide/a-z-word-list-term-collections/q/quit.md | 1 +
styleguide/a-z-word-list-term-collections/r/radio-button.md | 1 +
styleguide/a-z-word-list-term-collections/r/ragged-right.md | 1 +
styleguide/a-z-word-list-term-collections/r/ram.md | 1 +
styleguide/a-z-word-list-term-collections/r/range-selection.md | 1 +
styleguide/a-z-word-list-term-collections/r/re.md | 1 +
styleguide/a-z-word-list-term-collections/r/read-only.md | 1 +
.../r/read-write-read-write-permission.md | 1 +
styleguide/a-z-word-list-term-collections/r/real-time.md | 1 +
styleguide/a-z-word-list-term-collections/r/reboot.md | 1 +
styleguide/a-z-word-list-term-collections/r/recommend.md | 1 +
styleguide/a-z-word-list-term-collections/r/recycle-bin.md | 1 +
styleguide/a-z-word-list-term-collections/r/refresh.md | 1 +
.../r/registry-registry-settings.md | 1 +
styleguide/a-z-word-list-term-collections/r/reinitialize.md | 1 +
.../a-z-word-list-term-collections/r/relationship-chatbot.md | 1 +
styleguide/a-z-word-list-term-collections/r/rem-statement.md | 1 +
styleguide/a-z-word-list-term-collections/r/remote.md | 1 +
styleguide/a-z-word-list-term-collections/r/remove.md | 1 +
styleguide/a-z-word-list-term-collections/r/replace.md | 1 +
styleguide/a-z-word-list-term-collections/r/restart.md | 1 +
styleguide/a-z-word-list-term-collections/r/restore.md | 1 +
styleguide/a-z-word-list-term-collections/r/reverse-video.md | 1 +
.../r/right-align-right-aligned.md | 1 +
styleguide/a-z-word-list-term-collections/r/right-click.md | 1 +
.../r/right-justify-right-justified.md | 1 +
.../a-z-word-list-term-collections/r/right-mouse-button.md | 1 +
.../r/right-rightmost-right-hand.md | 1 +
styleguide/a-z-word-list-term-collections/r/rights.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/q/quality-high-quality.md b/styleguide/a-z-word-list-term-collections/q/quality-high-quality.md
index 5672f61f..10368817 100644
--- a/styleguide/a-z-word-list-term-collections/q/quality-high-quality.md
+++ b/styleguide/a-z-word-list-term-collections/q/quality-high-quality.md
@@ -1,5 +1,6 @@
---
title: quality, high-quality - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'quality' or 'high-quality' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/q/quit.md b/styleguide/a-z-word-list-term-collections/q/quit.md
index ae34fe72..d323bddd 100644
--- a/styleguide/a-z-word-list-term-collections/q/quit.md
+++ b/styleguide/a-z-word-list-term-collections/q/quit.md
@@ -1,5 +1,6 @@
---
title: quit - Microsoft Style Guide
+description: In this article, learn about guidelines for not using 'quit' and when to use 'stop responding' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/radio-button.md b/styleguide/a-z-word-list-term-collections/r/radio-button.md
index eb930a6b..a35a118a 100644
--- a/styleguide/a-z-word-list-term-collections/r/radio-button.md
+++ b/styleguide/a-z-word-list-term-collections/r/radio-button.md
@@ -1,5 +1,6 @@
---
title: radio button - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'radio button' and when to use 'option' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/ragged-right.md b/styleguide/a-z-word-list-term-collections/r/ragged-right.md
index d77f4a4c..57664d2a 100644
--- a/styleguide/a-z-word-list-term-collections/r/ragged-right.md
+++ b/styleguide/a-z-word-list-term-collections/r/ragged-right.md
@@ -1,5 +1,6 @@
---
title: ragged right - Microsoft Style Guide
+description: In this article, learn about guidelines for not using 'ragged right' and when to use 'left-aligned' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/ram.md b/styleguide/a-z-word-list-term-collections/r/ram.md
index c88194d3..b89d605b 100644
--- a/styleguide/a-z-word-list-term-collections/r/ram.md
+++ b/styleguide/a-z-word-list-term-collections/r/ram.md
@@ -1,5 +1,6 @@
---
title: RAM - Microsoft Style Guide
+description: In this article, learn about guidelines for using the term 'RAM' and where to find more information in the Microsoft Style Guide.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/range-selection.md b/styleguide/a-z-word-list-term-collections/r/range-selection.md
index 1fc4cfe9..bc01743c 100644
--- a/styleguide/a-z-word-list-term-collections/r/range-selection.md
+++ b/styleguide/a-z-word-list-term-collections/r/range-selection.md
@@ -1,5 +1,6 @@
---
title: range selection - Microsoft Style Guide
+description: In this article, learn about guidelines for not using 'range selection' and when to use 'multiple selection' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/re.md b/styleguide/a-z-word-list-term-collections/r/re.md
index 7ffd3a29..75a0c6a8 100644
--- a/styleguide/a-z-word-list-term-collections/r/re.md
+++ b/styleguide/a-z-word-list-term-collections/r/re.md
@@ -1,5 +1,6 @@
---
title: re- - Microsoft Style Guide
+description: In this article, learn about guidelines for using 're-' as a hyphenate in Microsoft documents and where to find more information about hyphenation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/read-only.md b/styleguide/a-z-word-list-term-collections/r/read-only.md
index a98c0501..e7951d90 100644
--- a/styleguide/a-z-word-list-term-collections/r/read-only.md
+++ b/styleguide/a-z-word-list-term-collections/r/read-only.md
@@ -1,5 +1,6 @@
---
title: read-only - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'read-only' in Microsoft documents and where to find more information about read/write permissions.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/read-write-read-write-permission.md b/styleguide/a-z-word-list-term-collections/r/read-write-read-write-permission.md
index 498a29c0..101cdd2b 100644
--- a/styleguide/a-z-word-list-term-collections/r/read-write-read-write-permission.md
+++ b/styleguide/a-z-word-list-term-collections/r/read-write-read-write-permission.md
@@ -1,5 +1,6 @@
---
title: read/write, read/write permission - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'read/write permissions' as a hyphenate in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/real-time.md b/styleguide/a-z-word-list-term-collections/r/real-time.md
index 1ec1656b..1d645e68 100644
--- a/styleguide/a-z-word-list-term-collections/r/real-time.md
+++ b/styleguide/a-z-word-list-term-collections/r/real-time.md
@@ -1,5 +1,6 @@
---
title: real time, real-time - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'real time' as a hyphenate in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/reboot.md b/styleguide/a-z-word-list-term-collections/r/reboot.md
index fd6cb2a1..b2da4775 100644
--- a/styleguide/a-z-word-list-term-collections/r/reboot.md
+++ b/styleguide/a-z-word-list-term-collections/r/reboot.md
@@ -1,5 +1,6 @@
---
title: reboot - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'reboot' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/recommend.md b/styleguide/a-z-word-list-term-collections/r/recommend.md
index 6dcc20a2..38840050 100644
--- a/styleguide/a-z-word-list-term-collections/r/recommend.md
+++ b/styleguide/a-z-word-list-term-collections/r/recommend.md
@@ -1,5 +1,6 @@
---
title: recommend - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'recommend' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/recycle-bin.md b/styleguide/a-z-word-list-term-collections/r/recycle-bin.md
index f73bd0c2..90c7861c 100644
--- a/styleguide/a-z-word-list-term-collections/r/recycle-bin.md
+++ b/styleguide/a-z-word-list-term-collections/r/recycle-bin.md
@@ -1,5 +1,6 @@
---
title: Recycle Bin, recycle bin - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'recycle bin' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/refresh.md b/styleguide/a-z-word-list-term-collections/r/refresh.md
index 058d6c8b..11929f80 100644
--- a/styleguide/a-z-word-list-term-collections/r/refresh.md
+++ b/styleguide/a-z-word-list-term-collections/r/refresh.md
@@ -1,5 +1,6 @@
---
title: refresh - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'refresh' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/registry-registry-settings.md b/styleguide/a-z-word-list-term-collections/r/registry-registry-settings.md
index 00ab8bcb..0b137ded 100644
--- a/styleguide/a-z-word-list-term-collections/r/registry-registry-settings.md
+++ b/styleguide/a-z-word-list-term-collections/r/registry-registry-settings.md
@@ -1,5 +1,6 @@
---
title: registry, registry settings - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'registry' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 08/16/2019
diff --git a/styleguide/a-z-word-list-term-collections/r/reinitialize.md b/styleguide/a-z-word-list-term-collections/r/reinitialize.md
index d7767acb..237133a5 100644
--- a/styleguide/a-z-word-list-term-collections/r/reinitialize.md
+++ b/styleguide/a-z-word-list-term-collections/r/reinitialize.md
@@ -1,5 +1,6 @@
---
title: reinitialize - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'reinitialize' in Microsoft documents and where to find information about the term 'initialize'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/relationship-chatbot.md b/styleguide/a-z-word-list-term-collections/r/relationship-chatbot.md
index 3e51a373..6fe11141 100644
--- a/styleguide/a-z-word-list-term-collections/r/relationship-chatbot.md
+++ b/styleguide/a-z-word-list-term-collections/r/relationship-chatbot.md
@@ -1,5 +1,6 @@
---
title: relationship chatbot - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'relationship chatbot' in Microsoft documents and where to find information about AI and bot term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/rem-statement.md b/styleguide/a-z-word-list-term-collections/r/rem-statement.md
index b22ccaea..12f94ef2 100644
--- a/styleguide/a-z-word-list-term-collections/r/rem-statement.md
+++ b/styleguide/a-z-word-list-term-collections/r/rem-statement.md
@@ -1,5 +1,6 @@
---
title: REM statement - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'REM statement' in Microsoft documents and when to use 'comment' instead.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/remote.md b/styleguide/a-z-word-list-term-collections/r/remote.md
index 0be90434..b74650c1 100644
--- a/styleguide/a-z-word-list-term-collections/r/remote.md
+++ b/styleguide/a-z-word-list-term-collections/r/remote.md
@@ -1,5 +1,6 @@
---
title: remote - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'remote' in Microsoft documents and when not to use the term.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/remove.md b/styleguide/a-z-word-list-term-collections/r/remove.md
index 9213b6ed..b18299e7 100644
--- a/styleguide/a-z-word-list-term-collections/r/remove.md
+++ b/styleguide/a-z-word-list-term-collections/r/remove.md
@@ -1,5 +1,6 @@
---
title: remove - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'remove' in Microsoft documents and where to find information about using the term 'uninstall'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/replace.md b/styleguide/a-z-word-list-term-collections/r/replace.md
index 92583721..6124e653 100644
--- a/styleguide/a-z-word-list-term-collections/r/replace.md
+++ b/styleguide/a-z-word-list-term-collections/r/replace.md
@@ -1,5 +1,6 @@
---
title: replace - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'replace' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/restart.md b/styleguide/a-z-word-list-term-collections/r/restart.md
index 5f016497..7a5f0329 100644
--- a/styleguide/a-z-word-list-term-collections/r/restart.md
+++ b/styleguide/a-z-word-list-term-collections/r/restart.md
@@ -1,5 +1,6 @@
---
title: restart - Microsoft Style Guide
+description: In this article, learn about the style guidelines for using the term 'restart' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/restore.md b/styleguide/a-z-word-list-term-collections/r/restore.md
index fe9a92f9..33ba3331 100644
--- a/styleguide/a-z-word-list-term-collections/r/restore.md
+++ b/styleguide/a-z-word-list-term-collections/r/restore.md
@@ -1,5 +1,6 @@
---
title: restore - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'restore' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/reverse-video.md b/styleguide/a-z-word-list-term-collections/r/reverse-video.md
index a5cc8567..1e15d39a 100644
--- a/styleguide/a-z-word-list-term-collections/r/reverse-video.md
+++ b/styleguide/a-z-word-list-term-collections/r/reverse-video.md
@@ -1,5 +1,6 @@
---
title: reverse video - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'reverse video' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/right-align-right-aligned.md b/styleguide/a-z-word-list-term-collections/r/right-align-right-aligned.md
index 71c2b398..2d01c282 100644
--- a/styleguide/a-z-word-list-term-collections/r/right-align-right-aligned.md
+++ b/styleguide/a-z-word-list-term-collections/r/right-align-right-aligned.md
@@ -1,5 +1,6 @@
---
title: right align, right-aligned - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'right align' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/right-click.md b/styleguide/a-z-word-list-term-collections/r/right-click.md
index f4777baa..65ae7e17 100644
--- a/styleguide/a-z-word-list-term-collections/r/right-click.md
+++ b/styleguide/a-z-word-list-term-collections/r/right-click.md
@@ -1,5 +1,6 @@
---
title: right-click - Microsoft Style Guide
+description: In this article, learn about guidelines for using 'right-click' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 09/21/2019
diff --git a/styleguide/a-z-word-list-term-collections/r/right-justify-right-justified.md b/styleguide/a-z-word-list-term-collections/r/right-justify-right-justified.md
index 58d866ba..407d2ecf 100644
--- a/styleguide/a-z-word-list-term-collections/r/right-justify-right-justified.md
+++ b/styleguide/a-z-word-list-term-collections/r/right-justify-right-justified.md
@@ -1,5 +1,6 @@
---
title: right justify, right-justified - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'right justify' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/right-mouse-button.md b/styleguide/a-z-word-list-term-collections/r/right-mouse-button.md
index aab5c35a..f6a8ee0d 100644
--- a/styleguide/a-z-word-list-term-collections/r/right-mouse-button.md
+++ b/styleguide/a-z-word-list-term-collections/r/right-mouse-button.md
@@ -1,5 +1,6 @@
---
title: right mouse button - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'right mouse button' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/right-rightmost-right-hand.md b/styleguide/a-z-word-list-term-collections/r/right-rightmost-right-hand.md
index 1da73699..88d52062 100644
--- a/styleguide/a-z-word-list-term-collections/r/right-rightmost-right-hand.md
+++ b/styleguide/a-z-word-list-term-collections/r/right-rightmost-right-hand.md
@@ -1,5 +1,6 @@
---
title: right, rightmost, right-hand - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'right' and 'rightmost' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/rights.md b/styleguide/a-z-word-list-term-collections/r/rights.md
index 357c02bc..43a43bd5 100644
--- a/styleguide/a-z-word-list-term-collections/r/rights.md
+++ b/styleguide/a-z-word-list-term-collections/r/rights.md
@@ -1,5 +1,6 @@
---
title: rights - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'rights' in Microsoft documents and see examples of its use in various scenarios.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 847cecf890225258b6c0f53f4ef209099a15d611 Mon Sep 17 00:00:00 2001
From: Dan Mabee <40476441+damabe@users.noreply.github.com>
Date: Fri, 3 Jun 2022 19:18:08 -0700
Subject: [PATCH 230/486] Build validation fixes
---
styleguide/a-z-word-list-term-collections/r/rom.md | 1 +
styleguide/a-z-word-list-term-collections/r/roman.md | 1 +
styleguide/a-z-word-list-term-collections/r/root-directory.md | 2 ++
styleguide/a-z-word-list-term-collections/r/rotate.md | 1 +
styleguide/a-z-word-list-term-collections/r/run-vs-execute.md | 1 +
.../r/running-foot-running-head.md | 1 +
styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md | 1 +
styleguide/a-z-word-list-term-collections/r/runtime.md | 1 +
.../a-z-word-list-term-collections/s/sample-vs-preview.md | 1 +
styleguide/a-z-word-list-term-collections/s/save.md | 1 +
styleguide/a-z-word-list-term-collections/s/scan-line.md | 1 +
.../a-z-word-list-term-collections/s/screen-resolution.md | 1 +
styleguide/a-z-word-list-term-collections/s/screen.md | 1 +
styleguide/a-z-word-list-term-collections/s/screened-subnet.md | 1 +
styleguide/a-z-word-list-term-collections/s/screenshot.md | 1 +
styleguide/a-z-word-list-term-collections/s/script-scriptlet.md | 1 +
.../s/scroll-bar-scroll-arrow-scroll-box.md | 1 +
styleguide/a-z-word-list-term-collections/s/scroll.md | 1 +
.../a-z-word-list-term-collections/s/search-and-replace.md | 1 +
styleguide/a-z-word-list-term-collections/s/search-box.md | 1 +
20 files changed, 21 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/r/rom.md b/styleguide/a-z-word-list-term-collections/r/rom.md
index d3b3da67..1571f851 100644
--- a/styleguide/a-z-word-list-term-collections/r/rom.md
+++ b/styleguide/a-z-word-list-term-collections/r/rom.md
@@ -1,5 +1,6 @@
---
title: ROM - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'ROM' in Microsoft documents and where to find information about the term 'memory'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/roman.md b/styleguide/a-z-word-list-term-collections/r/roman.md
index e316dad4..34b66719 100644
--- a/styleguide/a-z-word-list-term-collections/r/roman.md
+++ b/styleguide/a-z-word-list-term-collections/r/roman.md
@@ -1,5 +1,6 @@
---
title: Roman - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'Roman' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/root-directory.md b/styleguide/a-z-word-list-term-collections/r/root-directory.md
index 86e827c8..369f37e2 100644
--- a/styleguide/a-z-word-list-term-collections/r/root-directory.md
+++ b/styleguide/a-z-word-list-term-collections/r/root-directory.md
@@ -1,5 +1,7 @@
---
title: root directory - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'root directory' in Microsoft documents.
+
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/rotate.md b/styleguide/a-z-word-list-term-collections/r/rotate.md
index 2eb36b11..399a1f5b 100644
--- a/styleguide/a-z-word-list-term-collections/r/rotate.md
+++ b/styleguide/a-z-word-list-term-collections/r/rotate.md
@@ -1,5 +1,6 @@
---
title: rotate - Microsoft Style Guide
+description: Learn about style guidelines for using the term 'rotate' in Microsoft documents and where to find information about 'touch and pen interaction term collection'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/run-vs-execute.md b/styleguide/a-z-word-list-term-collections/r/run-vs-execute.md
index d42e8bf9..5d7f23a6 100644
--- a/styleguide/a-z-word-list-term-collections/r/run-vs-execute.md
+++ b/styleguide/a-z-word-list-term-collections/r/run-vs-execute.md
@@ -1,5 +1,6 @@
---
title: run vs. execute - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'run' and 'execute' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/running-foot-running-head.md b/styleguide/a-z-word-list-term-collections/r/running-foot-running-head.md
index bb148fa0..ad5dc543 100644
--- a/styleguide/a-z-word-list-term-collections/r/running-foot-running-head.md
+++ b/styleguide/a-z-word-list-term-collections/r/running-foot-running-head.md
@@ -1,5 +1,6 @@
---
title: running foot, running head - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'running foot' and 'running head' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md b/styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md
index 327a4352..f36b878c 100644
--- a/styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md
+++ b/styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md
@@ -1,5 +1,6 @@
---
title: runs vs. runs on - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'run' and 'runs on' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/runtime.md b/styleguide/a-z-word-list-term-collections/r/runtime.md
index b69613d8..7a696c6f 100644
--- a/styleguide/a-z-word-list-term-collections/r/runtime.md
+++ b/styleguide/a-z-word-list-term-collections/r/runtime.md
@@ -1,5 +1,6 @@
---
title: runtime - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'runtime' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/sample-vs-preview.md b/styleguide/a-z-word-list-term-collections/s/sample-vs-preview.md
index a8d8edfe..0e811566 100644
--- a/styleguide/a-z-word-list-term-collections/s/sample-vs-preview.md
+++ b/styleguide/a-z-word-list-term-collections/s/sample-vs-preview.md
@@ -1,5 +1,6 @@
---
title: sample vs. preview - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'style' and 'review' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/save.md b/styleguide/a-z-word-list-term-collections/s/save.md
index 8fc6af1f..2382e312 100644
--- a/styleguide/a-z-word-list-term-collections/s/save.md
+++ b/styleguide/a-z-word-list-term-collections/s/save.md
@@ -1,5 +1,6 @@
---
title: save - Microsoft Style Guide
+description: In this article, learn about the style guidelines for using the term 'save' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/scan-line.md b/styleguide/a-z-word-list-term-collections/s/scan-line.md
index 5d020797..b4eedc9e 100644
--- a/styleguide/a-z-word-list-term-collections/s/scan-line.md
+++ b/styleguide/a-z-word-list-term-collections/s/scan-line.md
@@ -1,5 +1,6 @@
---
title: scan line - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'scan line' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/screen-resolution.md b/styleguide/a-z-word-list-term-collections/s/screen-resolution.md
index 6f4c6fed..1548f919 100644
--- a/styleguide/a-z-word-list-term-collections/s/screen-resolution.md
+++ b/styleguide/a-z-word-list-term-collections/s/screen-resolution.md
@@ -1,5 +1,6 @@
---
title: screen resolution - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'screen resolution' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/screen.md b/styleguide/a-z-word-list-term-collections/s/screen.md
index a540848a..e2222213 100644
--- a/styleguide/a-z-word-list-term-collections/s/screen.md
+++ b/styleguide/a-z-word-list-term-collections/s/screen.md
@@ -1,5 +1,6 @@
---
title: screen - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'screen' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/screened-subnet.md b/styleguide/a-z-word-list-term-collections/s/screened-subnet.md
index 4f391a40..7d03d12e 100644
--- a/styleguide/a-z-word-list-term-collections/s/screened-subnet.md
+++ b/styleguide/a-z-word-list-term-collections/s/screened-subnet.md
@@ -1,5 +1,6 @@
---
title: screened subnet - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'screened subnet' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/screenshot.md b/styleguide/a-z-word-list-term-collections/s/screenshot.md
index acedfb0f..3f2700c0 100644
--- a/styleguide/a-z-word-list-term-collections/s/screenshot.md
+++ b/styleguide/a-z-word-list-term-collections/s/screenshot.md
@@ -1,5 +1,6 @@
---
title: screenshot - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'screenshot' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/script-scriptlet.md b/styleguide/a-z-word-list-term-collections/s/script-scriptlet.md
index edfd6aa6..a46b1f9d 100644
--- a/styleguide/a-z-word-list-term-collections/s/script-scriptlet.md
+++ b/styleguide/a-z-word-list-term-collections/s/script-scriptlet.md
@@ -1,5 +1,6 @@
---
title: script, scriptlet - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'script' and 'scriptlet' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/scroll-bar-scroll-arrow-scroll-box.md b/styleguide/a-z-word-list-term-collections/s/scroll-bar-scroll-arrow-scroll-box.md
index 08a40872..940ddaf1 100644
--- a/styleguide/a-z-word-list-term-collections/s/scroll-bar-scroll-arrow-scroll-box.md
+++ b/styleguide/a-z-word-list-term-collections/s/scroll-bar-scroll-arrow-scroll-box.md
@@ -1,5 +1,6 @@
---
title: scroll bar, scroll arrow, scroll box - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'scroll bar' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/scroll.md b/styleguide/a-z-word-list-term-collections/s/scroll.md
index d4ce66c0..16efdb36 100644
--- a/styleguide/a-z-word-list-term-collections/s/scroll.md
+++ b/styleguide/a-z-word-list-term-collections/s/scroll.md
@@ -1,5 +1,6 @@
---
title: scroll - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'scroll' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/search-and-replace.md b/styleguide/a-z-word-list-term-collections/s/search-and-replace.md
index 1a9d2aaf..a3255232 100644
--- a/styleguide/a-z-word-list-term-collections/s/search-and-replace.md
+++ b/styleguide/a-z-word-list-term-collections/s/search-and-replace.md
@@ -1,5 +1,6 @@
---
title: search, search and replace - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'search and replace' in Microsoft documents and other terms you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/s/search-box.md b/styleguide/a-z-word-list-term-collections/s/search-box.md
index ca54b072..10559719 100644
--- a/styleguide/a-z-word-list-term-collections/s/search-box.md
+++ b/styleguide/a-z-word-list-term-collections/s/search-box.md
@@ -1,5 +1,6 @@
---
title: search box - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'search box' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 0434ce2be5ae847f6368d8a9b63bb6a3c83ef549 Mon Sep 17 00:00:00 2001
From: Dan Mabee <40476441+damabe@users.noreply.github.com>
Date: Fri, 3 Jun 2022 20:47:29 -0700
Subject: [PATCH 231/486] Build validation fixes
---
styleguide/a-z-word-list-term-collections/c/character-set.md | 1 +
styleguide/a-z-word-list-term-collections/c/chart.md | 1 +
styleguide/a-z-word-list-term-collections/c/chat.md | 1 +
styleguide/a-z-word-list-term-collections/c/chatbot.md | 1 +
.../c/check-checkbox-check-mark.md | 1 +
styleguide/a-z-word-list-term-collections/c/check-in.md | 1 +
styleguide/a-z-word-list-term-collections/c/child-folder.md | 1 +
styleguide/a-z-word-list-term-collections/c/choose.md | 1 +
styleguide/a-z-word-list-term-collections/c/clear.md | 1 +
styleguide/a-z-word-list-term-collections/c/click.md | 1 +
styleguide/a-z-word-list-term-collections/r/root-directory.md | 1 -
11 files changed, 10 insertions(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/c/character-set.md b/styleguide/a-z-word-list-term-collections/c/character-set.md
index bc269389..2412836c 100644
--- a/styleguide/a-z-word-list-term-collections/c/character-set.md
+++ b/styleguide/a-z-word-list-term-collections/c/character-set.md
@@ -1,5 +1,6 @@
---
title: character set - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'character set' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/chart.md b/styleguide/a-z-word-list-term-collections/c/chart.md
index 3ed0a912..d89b983c 100644
--- a/styleguide/a-z-word-list-term-collections/c/chart.md
+++ b/styleguide/a-z-word-list-term-collections/c/chart.md
@@ -1,5 +1,6 @@
---
title: chart - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'chart' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/chat.md b/styleguide/a-z-word-list-term-collections/c/chat.md
index 4380b4eb..e31687bf 100644
--- a/styleguide/a-z-word-list-term-collections/c/chat.md
+++ b/styleguide/a-z-word-list-term-collections/c/chat.md
@@ -1,5 +1,6 @@
---
title: chat - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'chat' in Microsoft documentation and other terms that you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/chatbot.md b/styleguide/a-z-word-list-term-collections/c/chatbot.md
index 84cc7c33..58527fe1 100644
--- a/styleguide/a-z-word-list-term-collections/c/chatbot.md
+++ b/styleguide/a-z-word-list-term-collections/c/chatbot.md
@@ -1,5 +1,6 @@
---
title: chatbot - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'chatbot' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/check-checkbox-check-mark.md b/styleguide/a-z-word-list-term-collections/c/check-checkbox-check-mark.md
index 0c712b7a..eec76363 100644
--- a/styleguide/a-z-word-list-term-collections/c/check-checkbox-check-mark.md
+++ b/styleguide/a-z-word-list-term-collections/c/check-checkbox-check-mark.md
@@ -1,5 +1,6 @@
---
title: check, checkbox, check mark - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the terms 'check', 'checkbox, and 'check mark' in Microsoft documentats.
author: pallep
ms.author: pallep
ms.date: 03/29/2021
diff --git a/styleguide/a-z-word-list-term-collections/c/check-in.md b/styleguide/a-z-word-list-term-collections/c/check-in.md
index a5bf029f..e7c0a331 100644
--- a/styleguide/a-z-word-list-term-collections/c/check-in.md
+++ b/styleguide/a-z-word-list-term-collections/c/check-in.md
@@ -1,5 +1,6 @@
---
title: check in - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'check in' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/child-folder.md b/styleguide/a-z-word-list-term-collections/c/child-folder.md
index a38c3624..f5b30ff4 100644
--- a/styleguide/a-z-word-list-term-collections/c/child-folder.md
+++ b/styleguide/a-z-word-list-term-collections/c/child-folder.md
@@ -1,5 +1,6 @@
---
title: child folder - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'child folder' in Microsoft documentation and other terms that you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/choose.md b/styleguide/a-z-word-list-term-collections/c/choose.md
index 38d94c8c..08594a0c 100644
--- a/styleguide/a-z-word-list-term-collections/c/choose.md
+++ b/styleguide/a-z-word-list-term-collections/c/choose.md
@@ -1,5 +1,6 @@
---
title: choose - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'choose' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/clear.md b/styleguide/a-z-word-list-term-collections/c/clear.md
index c479741d..16a261ec 100644
--- a/styleguide/a-z-word-list-term-collections/c/clear.md
+++ b/styleguide/a-z-word-list-term-collections/c/clear.md
@@ -1,5 +1,6 @@
---
title: clear - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'clear' in Microsoft documentation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/click.md b/styleguide/a-z-word-list-term-collections/c/click.md
index efdf9b0c..b4eaab88 100644
--- a/styleguide/a-z-word-list-term-collections/c/click.md
+++ b/styleguide/a-z-word-list-term-collections/c/click.md
@@ -1,5 +1,6 @@
---
title: click - Microsoft Style Guide
+description: In this article, learn about style guidelines for using the term 'click' in Microsoft documentation and other terms that you can use in its place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/r/root-directory.md b/styleguide/a-z-word-list-term-collections/r/root-directory.md
index 369f37e2..900f119a 100644
--- a/styleguide/a-z-word-list-term-collections/r/root-directory.md
+++ b/styleguide/a-z-word-list-term-collections/r/root-directory.md
@@ -1,7 +1,6 @@
---
title: root directory - Microsoft Style Guide
description: In this article, learn about style guidelines for using the term 'root directory' in Microsoft documents.
-
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 2559495015619c19be5cfdef8d1ab0f68a31b7a6 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Sun, 5 Jun 2022 12:25:22 -0400
Subject: [PATCH 232/486] [Bulk] Validation Fixes
---
.../a/abort-abortion.md | 7 ++++---
.../a-z-word-list-term-collections/a/above.md | 5 +++--
.../a/access-key.md | 5 +++--
.../a-z-word-list-term-collections/a/access.md | 5 +++--
.../a/accessible.md | 5 +++--
.../a/achievement.md | 8 ++++----
.../a/actionable.md | 5 +++--
.../a/active-player-active-user.md | 5 +++--
.../a-z-word-list-term-collections/a/adapter.md | 5 +++--
.../accessibility-guidelines-requirements.md | 8 ++++----
.../colors-patterns-text-graphics-design.md | 15 +++++++++------
.../accessibility/graphics-design-media.md | 14 ++++++--------
.../accessibility/writing-all-abilities.md | 9 ++++-----
styleguide/acronyms.md | 16 ++++++----------
14 files changed, 58 insertions(+), 54 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/abort-abortion.md b/styleguide/a-z-word-list-term-collections/a/abort-abortion.md
index 0ee3a24d..fb52cae9 100644
--- a/styleguide/a-z-word-list-term-collections/a/abort-abortion.md
+++ b/styleguide/a-z-word-list-term-collections/a/abort-abortion.md
@@ -1,5 +1,6 @@
---
-title: abort, abortion - Microsoft Style Guide
+title: Abort, Abortion - Microsoft Style Guide
+description: This article outlines the use of the words abort and abortion per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# abort, abortion
+# Abort, Abortion
Never use *abortion.*
@@ -18,7 +19,7 @@ a technical audience only if it's part of the application
programming interface (API). Use an alternative term
in comments and descriptions.
-## Alternative terms
+## Alternative Terms
- *End:* use for communications and network connections.
- *Close:* use for apps and programs.
diff --git a/styleguide/a-z-word-list-term-collections/a/above.md b/styleguide/a-z-word-list-term-collections/a/above.md
index a14c18f5..e3360fee 100644
--- a/styleguide/a-z-word-list-term-collections/a/above.md
+++ b/styleguide/a-z-word-list-term-collections/a/above.md
@@ -1,5 +1,6 @@
---
-title: above - Microsoft Style Guide
+title: Above - Microsoft Style Guide
+description: This article outlines the use of the word above per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# above
+# Above
Don't use to mean *earlier*.
diff --git a/styleguide/a-z-word-list-term-collections/a/access-key.md b/styleguide/a-z-word-list-term-collections/a/access-key.md
index 09300f87..58171a7a 100644
--- a/styleguide/a-z-word-list-term-collections/a/access-key.md
+++ b/styleguide/a-z-word-list-term-collections/a/access-key.md
@@ -1,5 +1,6 @@
---
-title: access key - Microsoft Style Guide
+title: Access Key - Microsoft Style Guide
+description: This article provides a link to a keys and keyboard shortcuts term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# access key
+# Access Key
See [Keys and keyboard shortcuts term collection](/style-guide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts)
diff --git a/styleguide/a-z-word-list-term-collections/a/access.md b/styleguide/a-z-word-list-term-collections/a/access.md
index b515b2ae..f60d9eb5 100644
--- a/styleguide/a-z-word-list-term-collections/a/access.md
+++ b/styleguide/a-z-word-list-term-collections/a/access.md
@@ -1,5 +1,6 @@
---
-title: access - Microsoft Style Guide
+title: Access - Microsoft Style Guide
+description: This article outlines the use of the words access per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# access
+# Access
It's OK to use as a verb to mean *obtain access to*.
diff --git a/styleguide/a-z-word-list-term-collections/a/accessible.md b/styleguide/a-z-word-list-term-collections/a/accessible.md
index 11e697e5..4225ce79 100644
--- a/styleguide/a-z-word-list-term-collections/a/accessible.md
+++ b/styleguide/a-z-word-list-term-collections/a/accessible.md
@@ -1,5 +1,6 @@
---
-title: accessible - Microsoft Style Guide
+title: Accessible - Microsoft Style Guide
+description: This article outlines the use of the words accessible per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# accessible
+# Accessible
Reserve *accessible* and *accessibility* to refer to things that are easy to use for everyone, including people with disabilities.
diff --git a/styleguide/a-z-word-list-term-collections/a/achievement.md b/styleguide/a-z-word-list-term-collections/a/achievement.md
index 678f0900..f840e91c 100644
--- a/styleguide/a-z-word-list-term-collections/a/achievement.md
+++ b/styleguide/a-z-word-list-term-collections/a/achievement.md
@@ -1,5 +1,6 @@
---
-title: achievement - Microsoft Style Guide
+title: Achievement - Microsoft Style Guide
+description: This article outlines the use of the words achievement per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,10 +8,9 @@ ms.topic: article
ms.prod: non-product-specific
---
-# achievement
+# Achievement
-Refers
-to an accomplishment that's formally recognized by a game, site, or
+Refers to an accomplishment that's formally recognized by a game, site, or
app. Achievements are sometimes represented by a virtual badge, star,
medal, or other reward.
diff --git a/styleguide/a-z-word-list-term-collections/a/actionable.md b/styleguide/a-z-word-list-term-collections/a/actionable.md
index 883ace51..92b1dac7 100644
--- a/styleguide/a-z-word-list-term-collections/a/actionable.md
+++ b/styleguide/a-z-word-list-term-collections/a/actionable.md
@@ -1,5 +1,6 @@
---
-title: actionable - Microsoft Style Guide
+title: Actionable - Microsoft Style Guide
+description: This article tells the writer to avoid using the word actionable and provides alternatives.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# actionable
+# Actionable
Don't use unless you have no other choice.
diff --git a/styleguide/a-z-word-list-term-collections/a/active-player-active-user.md b/styleguide/a-z-word-list-term-collections/a/active-player-active-user.md
index a32523ee..a1ff457d 100644
--- a/styleguide/a-z-word-list-term-collections/a/active-player-active-user.md
+++ b/styleguide/a-z-word-list-term-collections/a/active-player-active-user.md
@@ -1,5 +1,6 @@
---
-title: active player, active user - Microsoft Style Guide
+title: Active Player, Active User - Microsoft Style Guide
+description: This article tells the writer to use the term active player rather than active user when referring to a person who's currently being tracked or recognized by a motion sensor or camera.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# active player, active user
+# Active Player, Active User
Use *active player,* not *active user,* to refer to a person who's currently being tracked or recognized by a motion sensor or camera.
diff --git a/styleguide/a-z-word-list-term-collections/a/adapter.md b/styleguide/a-z-word-list-term-collections/a/adapter.md
index 64417c83..c62dc318 100644
--- a/styleguide/a-z-word-list-term-collections/a/adapter.md
+++ b/styleguide/a-z-word-list-term-collections/a/adapter.md
@@ -1,5 +1,6 @@
---
-title: adapter - Microsoft Style Guide
+title: Adapter - Microsoft Style Guide
+description: For use of the word adapter per Microsoft style guidelines, this article links to a computer and device term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# adapter
+# Adapter
**See** [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md)
diff --git a/styleguide/accessibility/accessibility-guidelines-requirements.md b/styleguide/accessibility/accessibility-guidelines-requirements.md
index f8a0dfe9..8a6de3e5 100644
--- a/styleguide/accessibility/accessibility-guidelines-requirements.md
+++ b/styleguide/accessibility/accessibility-guidelines-requirements.md
@@ -1,5 +1,6 @@
---
-title: Accessibility guidelines and requirements - Microsoft Style Guide
+title: Accessibility Guidelines and Requirements - Microsoft Style Guide
+description: "This section provides a list of articles to accessibility style guidelines for Microsoft devices and services."
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,10 +8,9 @@ ms.topic: article
ms.prod: non-product-specific
---
-# Accessibility guidelines and requirements
+# Accessibility Guidelines and Requirements
-Microsoft
-devices and services empower people of all abilities, around the globe—at home, at work,
+Microsoft devices and services empower people of all abilities, around the globe—at home, at work,
and on the go—to do the activities they value most.
This section provides an overview of accessibility guidelines:
diff --git a/styleguide/accessibility/colors-patterns-text-graphics-design.md b/styleguide/accessibility/colors-patterns-text-graphics-design.md
index e783c2eb..f564050c 100644
--- a/styleguide/accessibility/colors-patterns-text-graphics-design.md
+++ b/styleguide/accessibility/colors-patterns-text-graphics-design.md
@@ -1,5 +1,6 @@
---
-title: Colors and patterns in text, graphics, and design - Microsoft Style Guide
+title: Colors and Patterns in Text, Graphics, and Design - Microsoft Style Guide
+description: This article provide accessibility style guidelines on colors and patterns in text, graphics, and design.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -9,8 +10,7 @@ ms.prod: non-product-specific
# Colors and patterns in text, graphics, and design
-Choose
-colors and patterns carefully. High contrast may improve
+Choose colors and patterns carefully. High contrast may improve
readability for people who have low vision. For people with some types
of color blindness, certain color combinations are difficult to
distinguish.
@@ -21,10 +21,13 @@ pattern and color to differentiate information in charts
and graphs. Remember that high-contrast personalization themes
in Windows alter text color.
-**Don’t hard-code colors**. They can become illegible in high-contrast themes.
+**Don’t hard-code colors.**
+They can become illegible in high-contrast themes.
-**Choose color combinations with a minimum contrast ratio of 4.5:1.** Don’t use low-contrast or hard-to-read color combinations, such as light green and white or red and green.
+**Choose color combinations with a minimum contrast ratio of 4.5:1.**
+Don’t use low-contrast or hard-to-read color combinations, such as light green and white or red and green.
**Don’t use screens or tints in art.**
-**Don’t use screened or shaded backgrounds, watermarks, or other images behind text**. Reduced contrast makes text harder to read and hinders screen readers.
+**Don’t use screened or shaded backgrounds, watermarks, or other images behind text.**
+Reduced contrast makes text harder to read and hinders screen readers.
diff --git a/styleguide/accessibility/graphics-design-media.md b/styleguide/accessibility/graphics-design-media.md
index 5313f07c..679cb78e 100644
--- a/styleguide/accessibility/graphics-design-media.md
+++ b/styleguide/accessibility/graphics-design-media.md
@@ -1,5 +1,6 @@
---
-title: Graphics, design, and media - Microsoft Style Guide
+title: Graphics, Design, and Media - Microsoft Style Guide
+description: This article provides an overview of accessibility style guidelines for Microsoft graphics, design, and media.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,15 +8,13 @@ ms.topic: article
ms.prod: non-product-specific
---
-# Graphics, design, and media
+# Graphics, Design, and Media
-Websites
-need to be accessible to everyone. Websites that are accessible
+Websites need to be accessible to everyone. Websites that are accessible
to people with disabilities also support customers with various
browsers, settings, and devices or who use older technologies.
-In
-general, use clean and simple graphic design. Provide alternate ways
+In general, use clean and simple graphic design. Provide alternate ways
to get the information that's conveyed by pictures, multimedia, and
image maps.
@@ -31,8 +30,7 @@ image maps.
## Images, image maps, and multimedia
-**Provide clear descriptions that don’t require pictures,**
-or provide both. Make sure the reader can get the whole story
+**Provide clear descriptions that don’t require pictures,** or provide both. Make sure the reader can get the whole story
from either the picture or the written description.
**Provide brief, accurate alt text for elements other than live text,** including
diff --git a/styleguide/accessibility/writing-all-abilities.md b/styleguide/accessibility/writing-all-abilities.md
index 24100680..8fa61e3e 100644
--- a/styleguide/accessibility/writing-all-abilities.md
+++ b/styleguide/accessibility/writing-all-abilities.md
@@ -1,5 +1,6 @@
---
-title: Writing for all abilities - Microsoft Style Guide
+title: Writing for All Abilities - Microsoft Style Guide
+description: This article guidelines on the Microsoft writing style to improve accessibility.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -9,16 +10,14 @@ ms.prod: non-product-specific
# Writing for all abilities
-Microsoft
-style—clean, simple design and crisp, clear content—is easier
+Microsoft style—clean, simple design and crisp, clear content—is easier
for all readers to use, so nearly every writing recommendation in
this guide will improve accessibility. Pay special attention to the
following guidelines.
## Put the person first
-In
-general, refer to a person who has a kind of disability, not a
+In general, refer to a person who has a kind of disability, not a
disabled person. When you must describe specific disabilities
or people with specific disabilities, use [approved terminology](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md "Accessibility term collection").
diff --git a/styleguide/acronyms.md b/styleguide/acronyms.md
index 0043c823..664c2efa 100644
--- a/styleguide/acronyms.md
+++ b/styleguide/acronyms.md
@@ -1,5 +1,6 @@
---
title: Acronyms - Microsoft Style Guide
+description: This article outlines how to write acronyms and abbreviations according to Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -9,16 +10,14 @@ ms.prod: non-product-specific
# Acronyms
-Acronyms
-and abbreviations can have an adverse effect on clarity, voice, and
+Acronyms and abbreviations can have an adverse effect on clarity, voice, and
SEO. Although some acronyms are widely understood and preferred to the
spelled-out term, others aren't well known or are familiar only to a
specific group of customers.
## Don't create acronyms from product or feature names
-Always
-spell out Microsoft product and feature names.
+Always spell out Microsoft product and feature names.
## Only use acronyms that your audience is familiar with
@@ -26,8 +25,7 @@ The A–Z word list has guidelines for many common acronyms, and some acronyms a
## If you have to use an acronym, also spell out the term for clarity
-In
-general, include the acronym in parentheses following the spelled-out
+In general, include the acronym in parentheses following the spelled-out
term. On subsequent mentions in the same article, page, or screen, you can
use the acronym without spelling it out.
@@ -50,8 +48,7 @@ term. Don't introduce it in parentheses after the spelled-out version.
## Be careful with acronyms in titles and headings
-Avoid
-using an acronym for the first time in a title or heading, unless it's a
+Avoid using an acronym for the first time in a title or heading, unless it's a
keyword that you need to place in the title or heading for SEO. If the
first use of the acronym is in a title or heading, introduce the acronym
(in parentheses, following the spelled-out term) in the following body
@@ -59,8 +56,7 @@ text.
## Lowercase the spelled-out term
-Lowercase
-all words in the spelled-out form of an acronym except for proper
+Lowercase all words in the spelled-out form of an acronym except for proper
nouns. The names of many protocols and specifications are considered
proper nouns and are capitalized when spelled out.
From 4b623f22133850eb3b2a9fd4f75acdc27e7602c9 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Sun, 5 Jun 2022 13:05:43 -0400
Subject: [PATCH 233/486] Additional Files & Typo Fixes
---
styleguide/a-z-word-list-term-collections/a/access.md | 2 +-
styleguide/a-z-word-list-term-collections/a/accessible.md | 2 +-
styleguide/a-z-word-list-term-collections/a/achievement.md | 2 +-
styleguide/a-z-word-list-term-collections/a/add-in-add-on.md | 5 +++--
styleguide/a-z-word-list-term-collections/a/add.md | 5 +++--
.../a-z-word-list-term-collections/a/adjacent-selection.md | 5 +++--
styleguide/a-z-word-list-term-collections/a/administer.md | 5 +++--
styleguide/a-z-word-list-term-collections/a/afterward.md | 3 ++-
.../accessibility/accessibility-guidelines-requirements.md | 2 +-
.../accessibility/colors-patterns-text-graphics-design.md | 2 +-
styleguide/accessibility/graphics-design-media.md | 2 +-
styleguide/accessibility/writing-all-abilities.md | 2 +-
styleguide/acronyms.md | 2 +-
13 files changed, 22 insertions(+), 17 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/access.md b/styleguide/a-z-word-list-term-collections/a/access.md
index f60d9eb5..832c8abd 100644
--- a/styleguide/a-z-word-list-term-collections/a/access.md
+++ b/styleguide/a-z-word-list-term-collections/a/access.md
@@ -1,6 +1,6 @@
---
title: Access - Microsoft Style Guide
-description: This article outlines the use of the words access per Microsoft style guidelines.
+description: This article outlines the use of the word access per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/accessible.md b/styleguide/a-z-word-list-term-collections/a/accessible.md
index 4225ce79..2191721f 100644
--- a/styleguide/a-z-word-list-term-collections/a/accessible.md
+++ b/styleguide/a-z-word-list-term-collections/a/accessible.md
@@ -1,6 +1,6 @@
---
title: Accessible - Microsoft Style Guide
-description: This article outlines the use of the words accessible per Microsoft style guidelines, with examples.
+description: This article outlines the use of the word accessible per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/achievement.md b/styleguide/a-z-word-list-term-collections/a/achievement.md
index f840e91c..105182fb 100644
--- a/styleguide/a-z-word-list-term-collections/a/achievement.md
+++ b/styleguide/a-z-word-list-term-collections/a/achievement.md
@@ -1,6 +1,6 @@
---
title: Achievement - Microsoft Style Guide
-description: This article outlines the use of the words achievement per Microsoft style guidelines, with examples.
+description: This article outlines the use of the word achievement per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/add-in-add-on.md b/styleguide/a-z-word-list-term-collections/a/add-in-add-on.md
index b2ec1e0a..5c899e6d 100644
--- a/styleguide/a-z-word-list-term-collections/a/add-in-add-on.md
+++ b/styleguide/a-z-word-list-term-collections/a/add-in-add-on.md
@@ -1,5 +1,6 @@
---
-title: add-in, add-on - Microsoft Style Guide
+title: Add-In, Add-On - Microsoft Style Guide
+description: This article outlines the use of the terms add-in and add-on per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# add-in, add-on
+# Add-In, Add-On
Use *add-in*
to refer to software that adds functionality to a larger program,
diff --git a/styleguide/a-z-word-list-term-collections/a/add.md b/styleguide/a-z-word-list-term-collections/a/add.md
index cdec74d3..993b1d52 100644
--- a/styleguide/a-z-word-list-term-collections/a/add.md
+++ b/styleguide/a-z-word-list-term-collections/a/add.md
@@ -1,5 +1,6 @@
---
-title: add - Microsoft Style Guide
+title: Add - Microsoft Style Guide
+description: This article outlines the use of the word add per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# add
+# Add
Use as a verb to describe installing add-ins and add-ons. Use *remove* to describe removing them.
diff --git a/styleguide/a-z-word-list-term-collections/a/adjacent-selection.md b/styleguide/a-z-word-list-term-collections/a/adjacent-selection.md
index 2fd7fc40..44d426e8 100644
--- a/styleguide/a-z-word-list-term-collections/a/adjacent-selection.md
+++ b/styleguide/a-z-word-list-term-collections/a/adjacent-selection.md
@@ -1,5 +1,6 @@
---
-title: adjacent selection - Microsoft Style Guide
+title: Adjacent Selection - Microsoft Style Guide
+description: This article outlines the use of the term adjacent selection per Microsoft style guidelines. If possible, the term multiple selection is preferred.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# adjacent selection
+# Adjacent Selection
Don't use if you can use *multiple selection* instead. It's OK to use *adjacent selection* if you must emphasize that the selected items are adjacent to one another.
diff --git a/styleguide/a-z-word-list-term-collections/a/administer.md b/styleguide/a-z-word-list-term-collections/a/administer.md
index cb7d59e3..8f1b4d31 100644
--- a/styleguide/a-z-word-list-term-collections/a/administer.md
+++ b/styleguide/a-z-word-list-term-collections/a/administer.md
@@ -1,5 +1,6 @@
---
-title: administer - Microsoft Style Guide
+title: Administer - Microsoft Style Guide
+description: In accordance with Microsoft style guidelines, this article tells the writer to use the word administer rather than administrate.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# administer
+# Administer
Use instead of *administrate*.
diff --git a/styleguide/a-z-word-list-term-collections/a/afterward.md b/styleguide/a-z-word-list-term-collections/a/afterward.md
index 95761f8c..ea296ebf 100644
--- a/styleguide/a-z-word-list-term-collections/a/afterward.md
+++ b/styleguide/a-z-word-list-term-collections/a/afterward.md
@@ -1,5 +1,6 @@
---
-title: afterward - Microsoft Style Guide
+title: Afterward - Microsoft Style Guide
+description: This article outlines the use of the word afterward per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/accessibility/accessibility-guidelines-requirements.md b/styleguide/accessibility/accessibility-guidelines-requirements.md
index 8a6de3e5..b4e1d2c2 100644
--- a/styleguide/accessibility/accessibility-guidelines-requirements.md
+++ b/styleguide/accessibility/accessibility-guidelines-requirements.md
@@ -1,6 +1,6 @@
---
title: Accessibility Guidelines and Requirements - Microsoft Style Guide
-description: "This section provides a list of articles to accessibility style guidelines for Microsoft devices and services."
+description: This section lists links to accessibility style guidelines for Microsoft devices and services.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/accessibility/colors-patterns-text-graphics-design.md b/styleguide/accessibility/colors-patterns-text-graphics-design.md
index f564050c..11e913a0 100644
--- a/styleguide/accessibility/colors-patterns-text-graphics-design.md
+++ b/styleguide/accessibility/colors-patterns-text-graphics-design.md
@@ -1,6 +1,6 @@
---
title: Colors and Patterns in Text, Graphics, and Design - Microsoft Style Guide
-description: This article provide accessibility style guidelines on colors and patterns in text, graphics, and design.
+description: This article provides Microsoft accessibility style guidelines on colors and patterns in text, graphics, and design.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/accessibility/graphics-design-media.md b/styleguide/accessibility/graphics-design-media.md
index 679cb78e..68c1f1bf 100644
--- a/styleguide/accessibility/graphics-design-media.md
+++ b/styleguide/accessibility/graphics-design-media.md
@@ -1,6 +1,6 @@
---
title: Graphics, Design, and Media - Microsoft Style Guide
-description: This article provides an overview of accessibility style guidelines for Microsoft graphics, design, and media.
+description: This article outlines Microsoft accessibility style guidelines for graphics, design, and media.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/accessibility/writing-all-abilities.md b/styleguide/accessibility/writing-all-abilities.md
index 8fa61e3e..9516576d 100644
--- a/styleguide/accessibility/writing-all-abilities.md
+++ b/styleguide/accessibility/writing-all-abilities.md
@@ -1,6 +1,6 @@
---
title: Writing for All Abilities - Microsoft Style Guide
-description: This article guidelines on the Microsoft writing style to improve accessibility.
+description: This article outlines Microsoft style guidelines for writing in order to improve accessibility.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/acronyms.md b/styleguide/acronyms.md
index 664c2efa..9682498c 100644
--- a/styleguide/acronyms.md
+++ b/styleguide/acronyms.md
@@ -1,6 +1,6 @@
---
title: Acronyms - Microsoft Style Guide
-description: This article outlines how to write acronyms and abbreviations according to Microsoft style guidelines, with examples.
+description: This article describes how to write acronyms and abbreviations per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 0223575c5e668c35f4b6b57dbcfc648b65fe3a19 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Sun, 5 Jun 2022 23:36:23 -0400
Subject: [PATCH 234/486] [Bulk] Validation Fixes
---
styleguide/a-z-word-list-term-collections/a/against.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/alarm.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/alert.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/alias.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/allow-allows.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/alphabetical.md | 1 +
styleguide/a-z-word-list-term-collections/a/alphanumeric.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/am-pm.md | 1 +
styleguide/a-z-word-list-term-collections/a/ampersand.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/and-or.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/and-so-on.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/antialiasing.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/antimalware.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/antispyware.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/antivirus.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/app-application.md | 3 ++-
.../a-z-word-list-term-collections/a/appendix-appendices.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/applet.md | 3 ++-
.../a/application-developer-app-developer.md | 3 ++-
.../a/application-file-app-file.md | 3 ++-
.../a/application-icon-app-icon.md | 3 ++-
21 files changed, 40 insertions(+), 19 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/against.md b/styleguide/a-z-word-list-term-collections/a/against.md
index 7a27e6bb..7f537953 100644
--- a/styleguide/a-z-word-list-term-collections/a/against.md
+++ b/styleguide/a-z-word-list-term-collections/a/against.md
@@ -1,5 +1,6 @@
---
-title: against - Microsoft Style Guide
+title: Against - Microsoft Style Guide
+description: This article outlines use of the word against per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/alarm.md b/styleguide/a-z-word-list-term-collections/a/alarm.md
index ca52414e..40f78c20 100644
--- a/styleguide/a-z-word-list-term-collections/a/alarm.md
+++ b/styleguide/a-z-word-list-term-collections/a/alarm.md
@@ -1,5 +1,6 @@
---
-title: alarm - Microsoft Style Guide
+title: Alarm - Microsoft Style Guide
+description: This article outlines use of the word alarm per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/alert.md b/styleguide/a-z-word-list-term-collections/a/alert.md
index 033736db..47d57a32 100644
--- a/styleguide/a-z-word-list-term-collections/a/alert.md
+++ b/styleguide/a-z-word-list-term-collections/a/alert.md
@@ -1,5 +1,6 @@
---
-title: alert - Microsoft Style Guide
+title: Alert - Microsoft Style Guide
+description: This article outlines use of the word alert per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/alias.md b/styleguide/a-z-word-list-term-collections/a/alias.md
index e08b10c4..56ec6ff1 100644
--- a/styleguide/a-z-word-list-term-collections/a/alias.md
+++ b/styleguide/a-z-word-list-term-collections/a/alias.md
@@ -1,5 +1,6 @@
---
-title: alias - Microsoft Style Guide
+title: Alias - Microsoft Style Guide
+description: This article outlines use of the word alias per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/allow-allows.md b/styleguide/a-z-word-list-term-collections/a/allow-allows.md
index f82edb0a..f2686245 100644
--- a/styleguide/a-z-word-list-term-collections/a/allow-allows.md
+++ b/styleguide/a-z-word-list-term-collections/a/allow-allows.md
@@ -1,5 +1,6 @@
---
-title: allow, allows - Microsoft Style Guide
+title: Allow, Allows - Microsoft Style Guide
+description: This article outlines use of the word allow/allows per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/alphabetical.md b/styleguide/a-z-word-list-term-collections/a/alphabetical.md
index fd128403..6af9138d 100644
--- a/styleguide/a-z-word-list-term-collections/a/alphabetical.md
+++ b/styleguide/a-z-word-list-term-collections/a/alphabetical.md
@@ -1,5 +1,6 @@
---
title: alphabetical - Microsoft Style Guide
+description: This article outlines use of the word alphabetical per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/alphanumeric.md b/styleguide/a-z-word-list-term-collections/a/alphanumeric.md
index 4d59a924..7a2ce09a 100644
--- a/styleguide/a-z-word-list-term-collections/a/alphanumeric.md
+++ b/styleguide/a-z-word-list-term-collections/a/alphanumeric.md
@@ -1,5 +1,6 @@
---
-title: alphanumeric - Microsoft Style Guide
+title: Alphanumeric - Microsoft Style Guide
+description: This article outlines use of the word alphanumeric per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/am-pm.md b/styleguide/a-z-word-list-term-collections/a/am-pm.md
index d6788106..08e239a7 100644
--- a/styleguide/a-z-word-list-term-collections/a/am-pm.md
+++ b/styleguide/a-z-word-list-term-collections/a/am-pm.md
@@ -1,5 +1,6 @@
---
title: AM, PM - Microsoft Style Guide
+description: This article links to a date and time term collection, in which contains how to use the AM/PM terms per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/ampersand.md b/styleguide/a-z-word-list-term-collections/a/ampersand.md
index 16da8759..7a0b29e6 100644
--- a/styleguide/a-z-word-list-term-collections/a/ampersand.md
+++ b/styleguide/a-z-word-list-term-collections/a/ampersand.md
@@ -1,5 +1,6 @@
---
-title: ampersand (&) - Microsoft Style Guide
+title: Ampersand (&) - Microsoft Style Guide
+description: This article outlines use of the ampersand (&) symbol per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/and-or.md b/styleguide/a-z-word-list-term-collections/a/and-or.md
index 25b82027..499f7e46 100644
--- a/styleguide/a-z-word-list-term-collections/a/and-or.md
+++ b/styleguide/a-z-word-list-term-collections/a/and-or.md
@@ -1,5 +1,6 @@
---
-title: and/or - Microsoft Style Guide
+title: And/Or - Microsoft Style Guide
+description: This article outlines use of and/or per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/and-so-on.md b/styleguide/a-z-word-list-term-collections/a/and-so-on.md
index 0a6a44b9..5fd186a5 100644
--- a/styleguide/a-z-word-list-term-collections/a/and-so-on.md
+++ b/styleguide/a-z-word-list-term-collections/a/and-so-on.md
@@ -1,5 +1,6 @@
---
-title: and so on - Microsoft Style Guide
+title: And So On - Microsoft Style Guide
+description: This article outlines use of the term and so on per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 06/27/2019
diff --git a/styleguide/a-z-word-list-term-collections/a/antialiasing.md b/styleguide/a-z-word-list-term-collections/a/antialiasing.md
index bb3fc1ce..f97fa61b 100644
--- a/styleguide/a-z-word-list-term-collections/a/antialiasing.md
+++ b/styleguide/a-z-word-list-term-collections/a/antialiasing.md
@@ -1,5 +1,6 @@
---
-title: antialiasing - Microsoft Style Guide
+title: Antialiasing - Microsoft Style Guide
+description: This article outlines use of the term antialiasing per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/antimalware.md b/styleguide/a-z-word-list-term-collections/a/antimalware.md
index a83bd86d..1db71d51 100644
--- a/styleguide/a-z-word-list-term-collections/a/antimalware.md
+++ b/styleguide/a-z-word-list-term-collections/a/antimalware.md
@@ -1,5 +1,6 @@
---
-title: antimalware - Microsoft Style Guide
+title: Antimalware - Microsoft Style Guide
+description: This article outlines use of the term antimalware per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/antispyware.md b/styleguide/a-z-word-list-term-collections/a/antispyware.md
index 820e25f1..1a5b1967 100644
--- a/styleguide/a-z-word-list-term-collections/a/antispyware.md
+++ b/styleguide/a-z-word-list-term-collections/a/antispyware.md
@@ -1,5 +1,6 @@
---
-title: antispyware - Microsoft Style Guide
+title: Antispyware - Microsoft Style Guide
+description: This article outlines use of the term antispyware per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/antivirus.md b/styleguide/a-z-word-list-term-collections/a/antivirus.md
index 8680c010..7c618c9b 100644
--- a/styleguide/a-z-word-list-term-collections/a/antivirus.md
+++ b/styleguide/a-z-word-list-term-collections/a/antivirus.md
@@ -1,5 +1,6 @@
---
-title: antivirus - Microsoft Style Guide
+title: Antivirus - Microsoft Style Guide
+description: This article outlines use of the word antivirus per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/app-application.md b/styleguide/a-z-word-list-term-collections/a/app-application.md
index b806bf4d..8fd3202a 100644
--- a/styleguide/a-z-word-list-term-collections/a/app-application.md
+++ b/styleguide/a-z-word-list-term-collections/a/app-application.md
@@ -1,5 +1,6 @@
---
-title: app, application - Microsoft Style Guide
+title: App, Application - Microsoft Style Guide
+description: This article outlines use of the words app/application per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/appendix-appendices.md b/styleguide/a-z-word-list-term-collections/a/appendix-appendices.md
index ba9ac96d..a14b38bd 100644
--- a/styleguide/a-z-word-list-term-collections/a/appendix-appendices.md
+++ b/styleguide/a-z-word-list-term-collections/a/appendix-appendices.md
@@ -1,5 +1,6 @@
---
-title: appendix, appendices - Microsoft Style Guide
+title: Appendix, Appendices - Microsoft Style Guide
+description: This article outlines use of the word appendix/appendices per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/applet.md b/styleguide/a-z-word-list-term-collections/a/applet.md
index 8d18d078..34ce9650 100644
--- a/styleguide/a-z-word-list-term-collections/a/applet.md
+++ b/styleguide/a-z-word-list-term-collections/a/applet.md
@@ -1,5 +1,6 @@
---
-title: applet - Microsoft Style Guide
+title: Applet - Microsoft Style Guide
+description: This article outlines use of the word applet per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/application-developer-app-developer.md b/styleguide/a-z-word-list-term-collections/a/application-developer-app-developer.md
index 78e2c386..185089f8 100644
--- a/styleguide/a-z-word-list-term-collections/a/application-developer-app-developer.md
+++ b/styleguide/a-z-word-list-term-collections/a/application-developer-app-developer.md
@@ -1,5 +1,6 @@
---
-title: application developer, app developer - Microsoft Style Guide
+title: Application Developer, App Developer - Microsoft Style Guide
+description: This article outlines use of the terms application developer/app developer per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/application-file-app-file.md b/styleguide/a-z-word-list-term-collections/a/application-file-app-file.md
index 4b47a786..4ff9781b 100644
--- a/styleguide/a-z-word-list-term-collections/a/application-file-app-file.md
+++ b/styleguide/a-z-word-list-term-collections/a/application-file-app-file.md
@@ -1,5 +1,6 @@
---
-title: application file, app file - Microsoft Style Guide
+title: Application File, App File - Microsoft Style Guide
+description: This article outlines use of the terms application file/app file per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/application-icon-app-icon.md b/styleguide/a-z-word-list-term-collections/a/application-icon-app-icon.md
index 4ccffdfc..3e2d3acc 100644
--- a/styleguide/a-z-word-list-term-collections/a/application-icon-app-icon.md
+++ b/styleguide/a-z-word-list-term-collections/a/application-icon-app-icon.md
@@ -1,5 +1,6 @@
---
-title: application icon, app icon - Microsoft Style Guide
+title: Application Icon, App Icon - Microsoft Style Guide
+description: This article outlines use of the terms application icon/app icon per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From d9dd01397effa383a5fe6cf9ee4da0eab25251fd Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Sun, 5 Jun 2022 23:56:12 -0400
Subject: [PATCH 235/486] [Bulk] Validation Fixes
---
.../a/application-window-app-window.md | 3 ++-
.../a-z-word-list-term-collections/a/argument-vs-parameter.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/arrow-keys.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/arrow.md | 3 ++-
.../a/artificial-intelligence-ai.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/as-well-as.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/ask.md | 3 ++-
.../a-z-word-list-term-collections/a/assembly-language.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/assistive.md | 3 ++-
.../a-z-word-list-term-collections/a/assure-ensure-insure.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/asterisk.md | 1 +
styleguide/a-z-word-list-term-collections/a/at-sign.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/attribute.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/audiobook.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/author.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/auto.md | 3 ++-
styleguide/a-z-word-list-term-collections/a/avg.md | 3 ++-
17 files changed, 33 insertions(+), 16 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/application-window-app-window.md b/styleguide/a-z-word-list-term-collections/a/application-window-app-window.md
index 06432156..82ff4847 100644
--- a/styleguide/a-z-word-list-term-collections/a/application-window-app-window.md
+++ b/styleguide/a-z-word-list-term-collections/a/application-window-app-window.md
@@ -1,5 +1,6 @@
---
-title: application window, app window - Microsoft Style Guide
+title: Application Window, App Window - Microsoft Style Guide
+description: This article outlines use of the terms application window/app window per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/argument-vs-parameter.md b/styleguide/a-z-word-list-term-collections/a/argument-vs-parameter.md
index 9255a480..9b087bf7 100644
--- a/styleguide/a-z-word-list-term-collections/a/argument-vs-parameter.md
+++ b/styleguide/a-z-word-list-term-collections/a/argument-vs-parameter.md
@@ -1,5 +1,6 @@
---
-title: argument vs. parameter - Microsoft Style Guide
+title: Argument vs. Parameter - Microsoft Style Guide
+description: This article outlines differences and uses of the words argument and parameter per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/arrow-keys.md b/styleguide/a-z-word-list-term-collections/a/arrow-keys.md
index 554fa342..0f8dc6a5 100644
--- a/styleguide/a-z-word-list-term-collections/a/arrow-keys.md
+++ b/styleguide/a-z-word-list-term-collections/a/arrow-keys.md
@@ -1,5 +1,6 @@
---
-title: arrow keys - Microsoft Style Guide
+title: Arrow Keys - Microsoft Style Guide
+description: This arrow keys article links to a keys and keyboard shortcuts term collection that's in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/arrow.md b/styleguide/a-z-word-list-term-collections/a/arrow.md
index 47308ef4..799e3ec5 100644
--- a/styleguide/a-z-word-list-term-collections/a/arrow.md
+++ b/styleguide/a-z-word-list-term-collections/a/arrow.md
@@ -1,5 +1,6 @@
---
-title: arrow - Microsoft Style Guide
+title: Arrow - Microsoft Style Guide
+description: This article outlines use of the word arrow per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/artificial-intelligence-ai.md b/styleguide/a-z-word-list-term-collections/a/artificial-intelligence-ai.md
index 900fb601..3983257c 100644
--- a/styleguide/a-z-word-list-term-collections/a/artificial-intelligence-ai.md
+++ b/styleguide/a-z-word-list-term-collections/a/artificial-intelligence-ai.md
@@ -1,5 +1,6 @@
---
-title: AI (artificial intelligence) - Microsoft Style Guide
+title: AI (Artificial Intelligence) - Microsoft Style Guide
+description: This article links to an AI and bot term collection that's in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/as-well-as.md b/styleguide/a-z-word-list-term-collections/a/as-well-as.md
index d903c12c..7309583a 100644
--- a/styleguide/a-z-word-list-term-collections/a/as-well-as.md
+++ b/styleguide/a-z-word-list-term-collections/a/as-well-as.md
@@ -1,5 +1,6 @@
---
-title: as well as - Microsoft Style Guide
+title: As Well As - Microsoft Style Guide
+description: This article outlines use of the term as well as per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/ask.md b/styleguide/a-z-word-list-term-collections/a/ask.md
index 8900f376..6792103b 100644
--- a/styleguide/a-z-word-list-term-collections/a/ask.md
+++ b/styleguide/a-z-word-list-term-collections/a/ask.md
@@ -1,5 +1,6 @@
---
-title: ask - Microsoft Style Guide
+title: Ask - Microsoft Style Guide
+description: This article outlines use of the word ask per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/assembly-language.md b/styleguide/a-z-word-list-term-collections/a/assembly-language.md
index ef76fff4..d89306b3 100644
--- a/styleguide/a-z-word-list-term-collections/a/assembly-language.md
+++ b/styleguide/a-z-word-list-term-collections/a/assembly-language.md
@@ -1,5 +1,6 @@
---
-title: assembly language - Microsoft Style Guide
+title: Assembly Language - Microsoft Style Guide
+description: This article outlines use of the term assembly language per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/assistive.md b/styleguide/a-z-word-list-term-collections/a/assistive.md
index b09d1662..04112d5a 100644
--- a/styleguide/a-z-word-list-term-collections/a/assistive.md
+++ b/styleguide/a-z-word-list-term-collections/a/assistive.md
@@ -1,5 +1,6 @@
---
-title: assistive - Microsoft Style Guide
+title: Assistive - Microsoft Style Guide
+description: This article outlines use of the word assistive per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/assure-ensure-insure.md b/styleguide/a-z-word-list-term-collections/a/assure-ensure-insure.md
index 5466e562..ae222ce1 100644
--- a/styleguide/a-z-word-list-term-collections/a/assure-ensure-insure.md
+++ b/styleguide/a-z-word-list-term-collections/a/assure-ensure-insure.md
@@ -1,5 +1,6 @@
---
-title: assure, ensure, insure - Microsoft Style Guide
+title: Assure, Ensure, Insure - Microsoft Style Guide
+description: This article outlines differences and uses of the words assure, ensure, and insure per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/asterisk.md b/styleguide/a-z-word-list-term-collections/a/asterisk.md
index 1b617b9c..4d7bf08d 100644
--- a/styleguide/a-z-word-list-term-collections/a/asterisk.md
+++ b/styleguide/a-z-word-list-term-collections/a/asterisk.md
@@ -1,5 +1,6 @@
---
title: asterisk (\*) - Microsoft Style Guide
+description: This article on the asterisk symbol in accordance with Microsoft style guidelines links to a keys and keyboard shortcuts term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/at-sign.md b/styleguide/a-z-word-list-term-collections/a/at-sign.md
index 05d43d78..ec4c1e2f 100644
--- a/styleguide/a-z-word-list-term-collections/a/at-sign.md
+++ b/styleguide/a-z-word-list-term-collections/a/at-sign.md
@@ -1,5 +1,6 @@
---
-title: at sign (@) - Microsoft Style Guide
+title: At Sign (@) - Microsoft Style Guide
+description: This article on using the at sign (@) in accordance with Microsoft style guidelines links to a keys and keyboard shortcuts term collection.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/attribute.md b/styleguide/a-z-word-list-term-collections/a/attribute.md
index b676f7ff..ae3de7d7 100644
--- a/styleguide/a-z-word-list-term-collections/a/attribute.md
+++ b/styleguide/a-z-word-list-term-collections/a/attribute.md
@@ -1,5 +1,6 @@
---
-title: attribute - Microsoft Style Guide
+title: Attribute - Microsoft Style Guide
+description: This article outlines use of the word attribute per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/audiobook.md b/styleguide/a-z-word-list-term-collections/a/audiobook.md
index 3be3e78a..7ed87fb1 100644
--- a/styleguide/a-z-word-list-term-collections/a/audiobook.md
+++ b/styleguide/a-z-word-list-term-collections/a/audiobook.md
@@ -1,5 +1,6 @@
---
-title: audiobook - Microsoft Style Guide
+title: Audiobook - Microsoft Style Guide
+description: This article outlines use of the word audiobook per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/author.md b/styleguide/a-z-word-list-term-collections/a/author.md
index 18dfb83c..7886d6c8 100644
--- a/styleguide/a-z-word-list-term-collections/a/author.md
+++ b/styleguide/a-z-word-list-term-collections/a/author.md
@@ -1,5 +1,6 @@
---
-title: author - Microsoft Style Guide
+title: Author - Microsoft Style Guide
+description: This article outlines use of the word author per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 08/8/2019
diff --git a/styleguide/a-z-word-list-term-collections/a/auto.md b/styleguide/a-z-word-list-term-collections/a/auto.md
index 0e4b2f6b..c206c879 100644
--- a/styleguide/a-z-word-list-term-collections/a/auto.md
+++ b/styleguide/a-z-word-list-term-collections/a/auto.md
@@ -1,5 +1,6 @@
---
-title: auto- - Microsoft Style Guide
+title: Auto- - Microsoft Style Guide
+description: This article outlines use of the word auto per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/a/avg.md b/styleguide/a-z-word-list-term-collections/a/avg.md
index 6d5be95a..9ce730df 100644
--- a/styleguide/a-z-word-list-term-collections/a/avg.md
+++ b/styleguide/a-z-word-list-term-collections/a/avg.md
@@ -1,5 +1,6 @@
---
-title: avg - Microsoft Style Guide
+title: Avg - Microsoft Style Guide
+description: This article outlines use of the abbreviation avg per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 11/26/2018
From 46aeaeaa8998251946509e599939fc5b52d35de9 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Sun, 5 Jun 2022 23:59:29 -0400
Subject: [PATCH 236/486] Build Report Fix
---
styleguide/a-z-word-list-term-collections/a/avg.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/avg.md b/styleguide/a-z-word-list-term-collections/a/avg.md
index 9ce730df..05c74121 100644
--- a/styleguide/a-z-word-list-term-collections/a/avg.md
+++ b/styleguide/a-z-word-list-term-collections/a/avg.md
@@ -5,7 +5,7 @@ author: pallep
ms.author: pallep
ms.date: 11/26/2018
ms.topic: article
-ms.prod: non-product specific
+ms.prod: non-product-specific
---
# avg
From f4cafbebb4d9765c6ecab10d778349d84710cfb1 Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Mon, 6 Jun 2022 08:36:52 -0700
Subject: [PATCH 237/486] BULK VALIDATION missing descriptions 060622-1
---
styleguide/a-z-word-list-term-collections/p/permissions.md | 1 +
.../p/personal-digital-assistant.md | 1 +
styleguide/a-z-word-list-term-collections/p/photo.md | 1 +
styleguide/a-z-word-list-term-collections/p/pinch.md | 1 +
styleguide/a-z-word-list-term-collections/p/ping-ping.md | 1 +
styleguide/a-z-word-list-term-collections/p/pipe.md | 1 +
styleguide/a-z-word-list-term-collections/p/placeholder.md | 1 +
.../a-z-word-list-term-collections/p/plaintext-plain-text.md | 1 +
.../a-z-word-list-term-collections/p/platform-as-a-service.md | 1 +
styleguide/a-z-word-list-term-collections/p/platform.md | 1 +
styleguide/a-z-word-list-term-collections/p/playlist.md | 1 +
styleguide/a-z-word-list-term-collections/p/please.md | 1 +
styleguide/a-z-word-list-term-collections/p/plug-and-play.md | 1 +
styleguide/a-z-word-list-term-collections/p/plug-in.md | 1 +
styleguide/a-z-word-list-term-collections/p/plus-sign.md | 1 +
styleguide/a-z-word-list-term-collections/p/point-to.md | 1 +
styleguide/a-z-word-list-term-collections/p/pointer.md | 1 +
styleguide/a-z-word-list-term-collections/p/pop-up.md | 1 +
styleguide/a-z-word-list-term-collections/p/port.md | 1 +
styleguide/a-z-word-list-term-collections/p/postal-code.md | 1 +
.../a-z-word-list-term-collections/p/pound-key-pound-sign.md | 1 +
styleguide/a-z-word-list-term-collections/p/power-cord.md | 1 +
.../p/power-down-power-up-power-off-power-on.md | 1 +
styleguide/a-z-word-list-term-collections/p/power-user.md | 1 +
styleguide/a-z-word-list-term-collections/p/pre.md | 1 +
styleguide/a-z-word-list-term-collections/p/preceding.md | 1 +
styleguide/a-z-word-list-term-collections/p/press-and-hold.md | 1 +
styleguide/a-z-word-list-term-collections/p/preview.md | 1 +
styleguide/a-z-word-list-term-collections/p/print-printout.md | 1 +
.../p/print-queue-printer-queue.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/p/permissions.md b/styleguide/a-z-word-list-term-collections/p/permissions.md
index ec6f4037..3f15fdab 100644
--- a/styleguide/a-z-word-list-term-collections/p/permissions.md
+++ b/styleguide/a-z-word-list-term-collections/p/permissions.md
@@ -1,5 +1,6 @@
---
title: permissions - Microsoft Style Guide
+description: Describes how to use the term "permissions" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/personal-digital-assistant.md b/styleguide/a-z-word-list-term-collections/p/personal-digital-assistant.md
index 5af991f4..25f0fdb8 100644
--- a/styleguide/a-z-word-list-term-collections/p/personal-digital-assistant.md
+++ b/styleguide/a-z-word-list-term-collections/p/personal-digital-assistant.md
@@ -1,5 +1,6 @@
---
title: personal digital assistant - Microsoft Style Guide
+description: Describes how to use the term "personal digital assistant" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/photo.md b/styleguide/a-z-word-list-term-collections/p/photo.md
index 8a76046b..e26edef7 100644
--- a/styleguide/a-z-word-list-term-collections/p/photo.md
+++ b/styleguide/a-z-word-list-term-collections/p/photo.md
@@ -1,5 +1,6 @@
---
title: photo - Microsoft Style Guide
+description: Describes how to use the term "photo" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pinch.md b/styleguide/a-z-word-list-term-collections/p/pinch.md
index 0948a835..c7b480a6 100644
--- a/styleguide/a-z-word-list-term-collections/p/pinch.md
+++ b/styleguide/a-z-word-list-term-collections/p/pinch.md
@@ -1,5 +1,6 @@
---
title: pinch - Microsoft Style Guide
+description: Describes how to use the term "pinch" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/ping-ping.md b/styleguide/a-z-word-list-term-collections/p/ping-ping.md
index 280f8b26..5351003f 100644
--- a/styleguide/a-z-word-list-term-collections/p/ping-ping.md
+++ b/styleguide/a-z-word-list-term-collections/p/ping-ping.md
@@ -1,5 +1,6 @@
---
title: ping, PING - Microsoft Style Guide
+description: Describes how to use the terms "ping" and "PING" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pipe.md b/styleguide/a-z-word-list-term-collections/p/pipe.md
index b6a9c371..6d3776e4 100644
--- a/styleguide/a-z-word-list-term-collections/p/pipe.md
+++ b/styleguide/a-z-word-list-term-collections/p/pipe.md
@@ -1,5 +1,6 @@
---
title: pipe - Microsoft Style Guide
+description: Describes how to use the term "pipe" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/placeholder.md b/styleguide/a-z-word-list-term-collections/p/placeholder.md
index 2c014c76..4741d6a2 100644
--- a/styleguide/a-z-word-list-term-collections/p/placeholder.md
+++ b/styleguide/a-z-word-list-term-collections/p/placeholder.md
@@ -1,5 +1,6 @@
---
title: placeholder - Microsoft Style Guide
+description: Describes how to use the term "placeholder" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/plaintext-plain-text.md b/styleguide/a-z-word-list-term-collections/p/plaintext-plain-text.md
index a3db2e36..49aafd5d 100644
--- a/styleguide/a-z-word-list-term-collections/p/plaintext-plain-text.md
+++ b/styleguide/a-z-word-list-term-collections/p/plaintext-plain-text.md
@@ -1,5 +1,6 @@
---
title: plaintext, plain text - Microsoft Style Guide
+description: Describes how to use the terms "plaintext" and "plain text" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/platform-as-a-service.md b/styleguide/a-z-word-list-term-collections/p/platform-as-a-service.md
index 621f7f79..afd2a510 100644
--- a/styleguide/a-z-word-list-term-collections/p/platform-as-a-service.md
+++ b/styleguide/a-z-word-list-term-collections/p/platform-as-a-service.md
@@ -1,5 +1,6 @@
---
title: platform as a service (PaaS) - Microsoft Style Guide
+description: Describes how to use the term "platform as a service (PaaS)" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/platform.md b/styleguide/a-z-word-list-term-collections/p/platform.md
index b06f05a3..f11c4e00 100644
--- a/styleguide/a-z-word-list-term-collections/p/platform.md
+++ b/styleguide/a-z-word-list-term-collections/p/platform.md
@@ -1,5 +1,6 @@
---
title: platform - Microsoft Style Guide
+description: Describes how to use the term "platform" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/playlist.md b/styleguide/a-z-word-list-term-collections/p/playlist.md
index 4a2f91df..0f04ad8c 100644
--- a/styleguide/a-z-word-list-term-collections/p/playlist.md
+++ b/styleguide/a-z-word-list-term-collections/p/playlist.md
@@ -1,5 +1,6 @@
---
title: playlist - Microsoft Style Guide
+description: Describes how to use the term "playlist" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/please.md b/styleguide/a-z-word-list-term-collections/p/please.md
index 5ce673db..6f11b157 100644
--- a/styleguide/a-z-word-list-term-collections/p/please.md
+++ b/styleguide/a-z-word-list-term-collections/p/please.md
@@ -1,5 +1,6 @@
---
title: please - Microsoft Style Guide
+description: Describes how to use the term "please" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/plug-and-play.md b/styleguide/a-z-word-list-term-collections/p/plug-and-play.md
index 52528ab2..0d233e06 100644
--- a/styleguide/a-z-word-list-term-collections/p/plug-and-play.md
+++ b/styleguide/a-z-word-list-term-collections/p/plug-and-play.md
@@ -1,5 +1,6 @@
---
title: Plug and Play, plug and play - Microsoft Style Guide
+description: Describes how to use the terms "Plug and Play" and "plug and play" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/plug-in.md b/styleguide/a-z-word-list-term-collections/p/plug-in.md
index c10b8380..7acf64d9 100644
--- a/styleguide/a-z-word-list-term-collections/p/plug-in.md
+++ b/styleguide/a-z-word-list-term-collections/p/plug-in.md
@@ -1,5 +1,6 @@
---
title: plug-in - Microsoft Style Guide
+description: Describes how to use the term "plug-in" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/plus-sign.md b/styleguide/a-z-word-list-term-collections/p/plus-sign.md
index 51d23dfc..b86922bd 100644
--- a/styleguide/a-z-word-list-term-collections/p/plus-sign.md
+++ b/styleguide/a-z-word-list-term-collections/p/plus-sign.md
@@ -1,5 +1,6 @@
---
title: plus sign (+) - Microsoft Style Guide
+description: Describes how to use the plus sign (+) in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/point-to.md b/styleguide/a-z-word-list-term-collections/p/point-to.md
index a6b98df1..bd2e7c4a 100644
--- a/styleguide/a-z-word-list-term-collections/p/point-to.md
+++ b/styleguide/a-z-word-list-term-collections/p/point-to.md
@@ -1,5 +1,6 @@
---
title: point to - Microsoft Style Guide
+description: Describes how to use the term "point to" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pointer.md b/styleguide/a-z-word-list-term-collections/p/pointer.md
index ae215e8c..56dd8196 100644
--- a/styleguide/a-z-word-list-term-collections/p/pointer.md
+++ b/styleguide/a-z-word-list-term-collections/p/pointer.md
@@ -1,5 +1,6 @@
---
title: pointer - Microsoft Style Guide
+description: Describes how to use the term "pointer" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pop-up.md b/styleguide/a-z-word-list-term-collections/p/pop-up.md
index cf891bfa..be696143 100644
--- a/styleguide/a-z-word-list-term-collections/p/pop-up.md
+++ b/styleguide/a-z-word-list-term-collections/p/pop-up.md
@@ -1,5 +1,6 @@
---
title: pop-up - Microsoft Style Guide
+description: Describes how to use the term "pop-up" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/port.md b/styleguide/a-z-word-list-term-collections/p/port.md
index 2831234d..46583c8c 100644
--- a/styleguide/a-z-word-list-term-collections/p/port.md
+++ b/styleguide/a-z-word-list-term-collections/p/port.md
@@ -1,5 +1,6 @@
---
title: port - Microsoft Style Guide
+description: Describes how to use the term "port" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/postal-code.md b/styleguide/a-z-word-list-term-collections/p/postal-code.md
index 452b7f73..23532152 100644
--- a/styleguide/a-z-word-list-term-collections/p/postal-code.md
+++ b/styleguide/a-z-word-list-term-collections/p/postal-code.md
@@ -1,5 +1,6 @@
---
title: postal code - Microsoft Style Guide
+description: Describes how to use the term "postal code" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pound-key-pound-sign.md b/styleguide/a-z-word-list-term-collections/p/pound-key-pound-sign.md
index cbeeb361..ae4b46c6 100644
--- a/styleguide/a-z-word-list-term-collections/p/pound-key-pound-sign.md
+++ b/styleguide/a-z-word-list-term-collections/p/pound-key-pound-sign.md
@@ -1,5 +1,6 @@
---
title: pound key, pound sign (\#) - Microsoft Style Guide
+description: Describes how to use the terms "pound key", "pound sign", or "#" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/power-cord.md b/styleguide/a-z-word-list-term-collections/p/power-cord.md
index e4d2efc7..4b358523 100644
--- a/styleguide/a-z-word-list-term-collections/p/power-cord.md
+++ b/styleguide/a-z-word-list-term-collections/p/power-cord.md
@@ -1,5 +1,6 @@
---
title: power cord - Microsoft Style Guide
+description: Describes how to use the term "power cord" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/power-down-power-up-power-off-power-on.md b/styleguide/a-z-word-list-term-collections/p/power-down-power-up-power-off-power-on.md
index 6e9e84d4..42c4a189 100644
--- a/styleguide/a-z-word-list-term-collections/p/power-down-power-up-power-off-power-on.md
+++ b/styleguide/a-z-word-list-term-collections/p/power-down-power-up-power-off-power-on.md
@@ -1,5 +1,6 @@
---
title: power down, power up, power off, power on - Microsoft Style Guide
+description: Describes how to use the terms "power down", "power up", "power off", and "power on" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/power-user.md b/styleguide/a-z-word-list-term-collections/p/power-user.md
index ac7fa2d5..16b983ad 100644
--- a/styleguide/a-z-word-list-term-collections/p/power-user.md
+++ b/styleguide/a-z-word-list-term-collections/p/power-user.md
@@ -1,5 +1,6 @@
---
title: power user - Microsoft Style Guide
+description: Describes how to use the term "power user" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pre.md b/styleguide/a-z-word-list-term-collections/p/pre.md
index c8f10da5..8854d5d4 100644
--- a/styleguide/a-z-word-list-term-collections/p/pre.md
+++ b/styleguide/a-z-word-list-term-collections/p/pre.md
@@ -1,5 +1,6 @@
---
title: pre- - Microsoft Style Guide
+description: Describes how to use the prefix "pre" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/preceding.md b/styleguide/a-z-word-list-term-collections/p/preceding.md
index b146074f..f6c5f76e 100644
--- a/styleguide/a-z-word-list-term-collections/p/preceding.md
+++ b/styleguide/a-z-word-list-term-collections/p/preceding.md
@@ -1,5 +1,6 @@
---
title: preceding - Microsoft Style Guide
+description: Describes how to use the term "preceding" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/press-and-hold.md b/styleguide/a-z-word-list-term-collections/p/press-and-hold.md
index 4b95acb9..85b28f29 100644
--- a/styleguide/a-z-word-list-term-collections/p/press-and-hold.md
+++ b/styleguide/a-z-word-list-term-collections/p/press-and-hold.md
@@ -1,5 +1,6 @@
---
title: press, press and hold - Microsoft Style Guide
+description: Describes how to use the terms "press" and "press and hold" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 09/21/2019
diff --git a/styleguide/a-z-word-list-term-collections/p/preview.md b/styleguide/a-z-word-list-term-collections/p/preview.md
index a8abd4ba..79da94c0 100644
--- a/styleguide/a-z-word-list-term-collections/p/preview.md
+++ b/styleguide/a-z-word-list-term-collections/p/preview.md
@@ -1,5 +1,6 @@
---
title: preview - Microsoft Style Guide
+description: Describes how to use the term "preview" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/print-printout.md b/styleguide/a-z-word-list-term-collections/p/print-printout.md
index db8bc0e4..6be24b67 100644
--- a/styleguide/a-z-word-list-term-collections/p/print-printout.md
+++ b/styleguide/a-z-word-list-term-collections/p/print-printout.md
@@ -1,5 +1,6 @@
---
title: print, printout - Microsoft Style Guide
+description: Describes how to use the terms "print" and "printout" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/print-queue-printer-queue.md b/styleguide/a-z-word-list-term-collections/p/print-queue-printer-queue.md
index 3f11d09f..eeaff5ac 100644
--- a/styleguide/a-z-word-list-term-collections/p/print-queue-printer-queue.md
+++ b/styleguide/a-z-word-list-term-collections/p/print-queue-printer-queue.md
@@ -1,5 +1,6 @@
---
title: print queue, printer queue - Microsoft Style Guide
+description: Describes how to use the terms "print queue" and "printer queue" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 00b34fcc9229962f83d980679319b1357451dcd4 Mon Sep 17 00:00:00 2001
From: mSarts <103003297+mSarts@users.noreply.github.com>
Date: Mon, 6 Jun 2022 08:54:08 -0700
Subject: [PATCH 238/486] BULK VALIDATION missing descriptions 060622-2
---
.../p/private-cloud-hosted-private-cloud.md | 1 +
styleguide/a-z-word-list-term-collections/p/privileges.md | 1 +
styleguide/a-z-word-list-term-collections/p/profile.md | 1 +
styleguide/a-z-word-list-term-collections/p/program-file.md | 1 +
styleguide/a-z-word-list-term-collections/p/program.md | 1 +
styleguide/a-z-word-list-term-collections/p/prompt.md | 1 +
styleguide/a-z-word-list-term-collections/p/prop.md | 1 +
.../p/property-sheet-property-page.md | 1 +
styleguide/a-z-word-list-term-collections/p/property.md | 1 +
styleguide/a-z-word-list-term-collections/p/protected-mode.md | 1 +
styleguide/a-z-word-list-term-collections/p/public-cloud.md | 1 +
styleguide/a-z-word-list-term-collections/p/pull-down.md | 1 +
styleguide/a-z-word-list-term-collections/p/purge.md | 1 +
styleguide/a-z-word-list-term-collections/p/push-button.md | 1 +
14 files changed, 14 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/p/private-cloud-hosted-private-cloud.md b/styleguide/a-z-word-list-term-collections/p/private-cloud-hosted-private-cloud.md
index 53c51434..5556b599 100644
--- a/styleguide/a-z-word-list-term-collections/p/private-cloud-hosted-private-cloud.md
+++ b/styleguide/a-z-word-list-term-collections/p/private-cloud-hosted-private-cloud.md
@@ -1,5 +1,6 @@
---
title: private cloud, hosted private cloud - Microsoft Style Guide
+description: Describes how to use the terms "private cloud" and "hosted private cloud" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/privileges.md b/styleguide/a-z-word-list-term-collections/p/privileges.md
index c5225966..869c7ce4 100644
--- a/styleguide/a-z-word-list-term-collections/p/privileges.md
+++ b/styleguide/a-z-word-list-term-collections/p/privileges.md
@@ -1,5 +1,6 @@
---
title: privileges - Microsoft Style Guide
+description: Describes how to use the term "privileges" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/profile.md b/styleguide/a-z-word-list-term-collections/p/profile.md
index 28ac1f25..425dad64 100644
--- a/styleguide/a-z-word-list-term-collections/p/profile.md
+++ b/styleguide/a-z-word-list-term-collections/p/profile.md
@@ -1,5 +1,6 @@
---
title: profile - Microsoft Style Guide
+description: Describes how to use the term "profile" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/program-file.md b/styleguide/a-z-word-list-term-collections/p/program-file.md
index 7ad7cedf..6a1c33d9 100644
--- a/styleguide/a-z-word-list-term-collections/p/program-file.md
+++ b/styleguide/a-z-word-list-term-collections/p/program-file.md
@@ -1,5 +1,6 @@
---
title: program file - Microsoft Style Guide
+description: Describes how to use the term "program file" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/program.md b/styleguide/a-z-word-list-term-collections/p/program.md
index 2f264c39..2629123a 100644
--- a/styleguide/a-z-word-list-term-collections/p/program.md
+++ b/styleguide/a-z-word-list-term-collections/p/program.md
@@ -1,5 +1,6 @@
---
title: program - Microsoft Style Guide
+description: Describes how to use the term "program" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/prompt.md b/styleguide/a-z-word-list-term-collections/p/prompt.md
index af4cc6a0..6129764d 100644
--- a/styleguide/a-z-word-list-term-collections/p/prompt.md
+++ b/styleguide/a-z-word-list-term-collections/p/prompt.md
@@ -1,5 +1,6 @@
---
title: prompt - Microsoft Style Guide
+description: Describes how to use the term "prompt" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/prop.md b/styleguide/a-z-word-list-term-collections/p/prop.md
index 05738ffe..529c0b7b 100644
--- a/styleguide/a-z-word-list-term-collections/p/prop.md
+++ b/styleguide/a-z-word-list-term-collections/p/prop.md
@@ -1,5 +1,6 @@
---
title: prop - Microsoft Style Guide
+description: Describes how to use the term "prop" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/property-sheet-property-page.md b/styleguide/a-z-word-list-term-collections/p/property-sheet-property-page.md
index 628ade34..a1c6e186 100644
--- a/styleguide/a-z-word-list-term-collections/p/property-sheet-property-page.md
+++ b/styleguide/a-z-word-list-term-collections/p/property-sheet-property-page.md
@@ -1,5 +1,6 @@
---
title: property sheet, property page - Microsoft Style Guide
+description: Describes how to use the terms "property sheet" and "property page in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/property.md b/styleguide/a-z-word-list-term-collections/p/property.md
index c0bd517e..6fb2ecf0 100644
--- a/styleguide/a-z-word-list-term-collections/p/property.md
+++ b/styleguide/a-z-word-list-term-collections/p/property.md
@@ -1,5 +1,6 @@
---
title: property - Microsoft Style Guide
+description: Describes how to use the term "property" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/protected-mode.md b/styleguide/a-z-word-list-term-collections/p/protected-mode.md
index e8c62a38..feeff734 100644
--- a/styleguide/a-z-word-list-term-collections/p/protected-mode.md
+++ b/styleguide/a-z-word-list-term-collections/p/protected-mode.md
@@ -1,5 +1,6 @@
---
title: protected mode - Microsoft Style Guide
+description: Describes how to use the term "protected mode" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/public-cloud.md b/styleguide/a-z-word-list-term-collections/p/public-cloud.md
index 99187696..e64308e4 100644
--- a/styleguide/a-z-word-list-term-collections/p/public-cloud.md
+++ b/styleguide/a-z-word-list-term-collections/p/public-cloud.md
@@ -1,5 +1,6 @@
---
title: public cloud - Microsoft Style Guide
+description: Describes how to use the term "public cloud" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pull-down.md b/styleguide/a-z-word-list-term-collections/p/pull-down.md
index fd9218cd..a6ba7c9f 100644
--- a/styleguide/a-z-word-list-term-collections/p/pull-down.md
+++ b/styleguide/a-z-word-list-term-collections/p/pull-down.md
@@ -1,5 +1,6 @@
---
title: pull-down - Microsoft Style Guide
+description: Describes how to use the term "pull-down" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 04/01/2021
diff --git a/styleguide/a-z-word-list-term-collections/p/purge.md b/styleguide/a-z-word-list-term-collections/p/purge.md
index 690e0113..986c4a3b 100644
--- a/styleguide/a-z-word-list-term-collections/p/purge.md
+++ b/styleguide/a-z-word-list-term-collections/p/purge.md
@@ -1,5 +1,6 @@
---
title: purge - Microsoft Style Guide
+description: Describes how to use the term "purge" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/push-button.md b/styleguide/a-z-word-list-term-collections/p/push-button.md
index dfbb1ad1..c23e4db6 100644
--- a/styleguide/a-z-word-list-term-collections/p/push-button.md
+++ b/styleguide/a-z-word-list-term-collections/p/push-button.md
@@ -1,5 +1,6 @@
---
title: push button, push-button - Microsoft Style Guide
+description: Describes how to use the terms "push button" and "push-button" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From b7bb78d6632e092d157834918dc01aa6e5626658 Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Mon, 6 Jun 2022 17:01:55 -0500
Subject: [PATCH 239/486] [Bulk] Validation: fixing missing descriptions-cc2
---
styleguide/a-z-word-list-term-collections/w/write-only.md | 1 +
.../w/write-protect-write-protected.md | 1 +
styleguide/a-z-word-list-term-collections/x/x-axis.md | 1 +
styleguide/a-z-word-list-term-collections/x/x-coordinate.md | 1 +
styleguide/a-z-word-list-term-collections/x/x.md | 1 +
styleguide/a-z-word-list-term-collections/x/xon-xoff.md | 1 +
styleguide/a-z-word-list-term-collections/y/y-axis.md | 1 +
styleguide/a-z-word-list-term-collections/y/y-coordinate.md | 1 +
styleguide/a-z-word-list-term-collections/z/z-axis.md | 1 +
styleguide/a-z-word-list-term-collections/z/z.md | 1 +
styleguide/a-z-word-list-term-collections/z/zero-zeros.md | 1 +
styleguide/a-z-word-list-term-collections/z/zip-code.md | 1 +
styleguide/a-z-word-list-term-collections/z/zoom-in-zoom-out.md | 1 +
styleguide/brand-voice-above-all-simple-human.md | 1 +
styleguide/capitalization.md | 1 +
styleguide/chatbots-virtual-agents/care-feeding-bot.md | 1 +
styleguide/chatbots-virtual-agents/index.md | 1 +
.../structural-technical-considerations.md | 1 +
styleguide/chatbots-virtual-agents/writing-bots.md | 1 +
styleguide/content-planning.md | 1 +
styleguide/design-planning.md | 1 +
styleguide/developer-content/code-examples.md | 1 +
.../developer-content/formatting-developer-text-elements.md | 1 +
styleguide/developer-content/index.md | 1 +
styleguide/developer-content/reference-documentation.md | 1 +
25 files changed, 25 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/w/write-only.md b/styleguide/a-z-word-list-term-collections/w/write-only.md
index 1e3e3d5c..8aeb99b2 100644
--- a/styleguide/a-z-word-list-term-collections/w/write-only.md
+++ b/styleguide/a-z-word-list-term-collections/w/write-only.md
@@ -1,6 +1,7 @@
---
title: write-only - Microsoft Style Guide
author: pallep
+description: This instructs to always hyphenate with the terms "write-only."
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/w/write-protect-write-protected.md b/styleguide/a-z-word-list-term-collections/w/write-protect-write-protected.md
index eb0647c4..14ca89b4 100644
--- a/styleguide/a-z-word-list-term-collections/w/write-protect-write-protected.md
+++ b/styleguide/a-z-word-list-term-collections/w/write-protect-write-protected.md
@@ -1,6 +1,7 @@
---
title: write-protect, write-protected - Microsoft Style Guide
author: pallep
+description: Instructs to use "write-protect" as a verb instead of "lock" to refer to the action of protecting disks from being overwritten, use "write-protected" as an adjective, and to always hyphenate both.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/x/x-axis.md b/styleguide/a-z-word-list-term-collections/x/x-axis.md
index 41707ca5..16e760fc 100644
--- a/styleguide/a-z-word-list-term-collections/x/x-axis.md
+++ b/styleguide/a-z-word-list-term-collections/x/x-axis.md
@@ -1,6 +1,7 @@
---
title: x-axis - Microsoft Style Guide
author: pallep
+description: Instructs to lowercase and hyphenate "x-axis" and on first mention, use category (x) axis to refer to the horizontal axis in charts and graphs.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/x/x-coordinate.md b/styleguide/a-z-word-list-term-collections/x/x-coordinate.md
index b9b7591a..9be44664 100644
--- a/styleguide/a-z-word-list-term-collections/x/x-coordinate.md
+++ b/styleguide/a-z-word-list-term-collections/x/x-coordinate.md
@@ -1,6 +1,7 @@
---
title: x-coordinate - Microsoft Style Guide
author: pallep
+description: Instructs to lowercase and hyphenate the "x-coordinate," but to not use italic formatting for the x in x-coordinate unless the entire word is italic.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/x/x.md b/styleguide/a-z-word-list-term-collections/x/x.md
index a097cb43..8ff0178b 100644
--- a/styleguide/a-z-word-list-term-collections/x/x.md
+++ b/styleguide/a-z-word-list-term-collections/x/x.md
@@ -1,6 +1,7 @@
---
title: x - Microsoft Style Guide
author: pallep
+description: Instructs to use a lowercase "x" in italic type as a placeholder number or variable, but not to use it to refer to a generic, unspecified number.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/x/xon-xoff.md b/styleguide/a-z-word-list-term-collections/x/xon-xoff.md
index 8d1f2da3..be705ccd 100644
--- a/styleguide/a-z-word-list-term-collections/x/xon-xoff.md
+++ b/styleguide/a-z-word-list-term-collections/x/xon-xoff.md
@@ -1,6 +1,7 @@
---
title: XON/XOFF - Microsoft Style Guide
author: pallep
+description: States to note the capitalization and slash on "XON/XOFF."
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/y/y-axis.md b/styleguide/a-z-word-list-term-collections/y/y-axis.md
index be5f6be0..75ffafbc 100644
--- a/styleguide/a-z-word-list-term-collections/y/y-axis.md
+++ b/styleguide/a-z-word-list-term-collections/y/y-axis.md
@@ -1,6 +1,7 @@
---
title: y-axis - Microsoft Style Guide
author: pallep
+description: Instructs to lowercase and hyphenate the term "y-axis," but on first mention, refer to the y-axis as the value (y) axis.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/y/y-coordinate.md b/styleguide/a-z-word-list-term-collections/y/y-coordinate.md
index 8339ed97..c3b456ad 100644
--- a/styleguide/a-z-word-list-term-collections/y/y-coordinate.md
+++ b/styleguide/a-z-word-list-term-collections/y/y-coordinate.md
@@ -1,6 +1,7 @@
---
title: y-coordinate - Microsoft Style Guide
author: pallep
+description: Instructs to lowercase and hyphenate the "y-coordinate" and not to use italic formatting for the y in y-coordinate unless the entire word is italic.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/z/z-axis.md b/styleguide/a-z-word-list-term-collections/z/z-axis.md
index d0477be8..1d1614ef 100644
--- a/styleguide/a-z-word-list-term-collections/z/z-axis.md
+++ b/styleguide/a-z-word-list-term-collections/z/z-axis.md
@@ -1,6 +1,7 @@
---
title: z-axis - Microsoft Style Guide
author: pallep
+description: Discusses that in 3D charts, the z-axis shows depth and generally represents values, but instructs to lowercase and hyphenate the z-axis.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/z/z.md b/styleguide/a-z-word-list-term-collections/z/z.md
index e1427fac..0bd4e527 100644
--- a/styleguide/a-z-word-list-term-collections/z/z.md
+++ b/styleguide/a-z-word-list-term-collections/z/z.md
@@ -1,6 +1,7 @@
---
title: z- - Microsoft Style Guide
author: pallep
+description: Instructs to hyphenate all words referring to entities that begin with z used as a separate letter, such as z-axis, z-coordinate, z-order, and z-test.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/z/zero-zeros.md b/styleguide/a-z-word-list-term-collections/z/zero-zeros.md
index e4946ef1..806c5bc9 100644
--- a/styleguide/a-z-word-list-term-collections/z/zero-zeros.md
+++ b/styleguide/a-z-word-list-term-collections/z/zero-zeros.md
@@ -1,6 +1,7 @@
---
title: zero, zeros - Microsoft Style Guide
author: pallep
+description: Discusses when a measurement includes 0, use the plural form of the spelled-out unit of measure, such as zero, not zeroes, as the plural of zero.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/z/zip-code.md b/styleguide/a-z-word-list-term-collections/z/zip-code.md
index 552eb73b..7fb1ce38 100644
--- a/styleguide/a-z-word-list-term-collections/z/zip-code.md
+++ b/styleguide/a-z-word-list-term-collections/z/zip-code.md
@@ -1,6 +1,7 @@
---
title: ZIP Code - Microsoft Style Guide
author: pallep
+description: Discusses that it's OK to use ZIP Code in content that's intended for a US audience only. Otherwise, use postal code.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/a-z-word-list-term-collections/z/zoom-in-zoom-out.md b/styleguide/a-z-word-list-term-collections/z/zoom-in-zoom-out.md
index 1444922b..f6101d29 100644
--- a/styleguide/a-z-word-list-term-collections/z/zoom-in-zoom-out.md
+++ b/styleguide/a-z-word-list-term-collections/z/zoom-in-zoom-out.md
@@ -1,6 +1,7 @@
---
title: zoom in, zoom out - Microsoft Style Guide
author: pallep
+description: Instructs to use zoom in and zoom out as generic verbs in instructions for all input methods, but not to use dezoom or unzoom.
ms.author: pallep
ms.date: 01/19/2018
ms.topic: article
diff --git a/styleguide/brand-voice-above-all-simple-human.md b/styleguide/brand-voice-above-all-simple-human.md
index eb7ef652..fd627ac1 100644
--- a/styleguide/brand-voice-above-all-simple-human.md
+++ b/styleguide/brand-voice-above-all-simple-human.md
@@ -1,5 +1,6 @@
---
title: Microsoft's brand voice : above all, simple and human - Microsoft Style Guide
+description: Discusses Microsoft's brand voice, which is simple and human, such as "what" we say, our message, and "how" we say it, our voice.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/capitalization.md b/styleguide/capitalization.md
index 473c7bd5..c7fbbd12 100644
--- a/styleguide/capitalization.md
+++ b/styleguide/capitalization.md
@@ -1,5 +1,6 @@
---
title: Capitalization - Microsoft Style Guide
+description: Microsoft style uses sentence-style capitalization. That means everything is lowercase except the first word and proper nouns.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/chatbots-virtual-agents/care-feeding-bot.md b/styleguide/chatbots-virtual-agents/care-feeding-bot.md
index 5ac2b8d0..bb193bdc 100644
--- a/styleguide/chatbots-virtual-agents/care-feeding-bot.md
+++ b/styleguide/chatbots-virtual-agents/care-feeding-bot.md
@@ -1,5 +1,6 @@
---
title: Care and feeding of the bot - Microsoft Style Guide
+description: Instructs maintaining the bot and evaluating its effectiveness over time, such as what's working and what isn't.
author: pallep
ms.author: pallep
ms.date: 02/21/2019
diff --git a/styleguide/chatbots-virtual-agents/index.md b/styleguide/chatbots-virtual-agents/index.md
index 5b4646a5..0746a859 100644
--- a/styleguide/chatbots-virtual-agents/index.md
+++ b/styleguide/chatbots-virtual-agents/index.md
@@ -1,5 +1,6 @@
---
title: Chatbots and virtual agents - Microsoft Style Guide
+description: Discusses chatbots and virtual agents, which is a type of bot that can be used to provide information and answers, and complete tasks.
author: pallep
ms.author: pallep
ms.date: 02/21/2019
diff --git a/styleguide/chatbots-virtual-agents/structural-technical-considerations.md b/styleguide/chatbots-virtual-agents/structural-technical-considerations.md
index f4230f08..4b359d9f 100644
--- a/styleguide/chatbots-virtual-agents/structural-technical-considerations.md
+++ b/styleguide/chatbots-virtual-agents/structural-technical-considerations.md
@@ -1,5 +1,6 @@
---
title: Structural and technical considerations - Microsoft Style Guide
+description: Discusses clarify intent before acting, on structural and technical considerations, until you're sure your bot can reliably interpret conversational cues.
author: pallep
ms.author: pallep
ms.date: 02/21/2019
diff --git a/styleguide/chatbots-virtual-agents/writing-bots.md b/styleguide/chatbots-virtual-agents/writing-bots.md
index ef054c75..a1fcc110 100644
--- a/styleguide/chatbots-virtual-agents/writing-bots.md
+++ b/styleguide/chatbots-virtual-agents/writing-bots.md
@@ -1,5 +1,6 @@
---
title: Writing for bots - Microsoft Style Guide
+description: Discusses writing for bots and to be friendly while helping to complete the task, such as tailoring the tone of the bot's response to the context.
author: pallep
ms.author: pallep
ms.date: 02/21/2019
diff --git a/styleguide/content-planning.md b/styleguide/content-planning.md
index 0a428e5c..7ef77724 100644
--- a/styleguide/content-planning.md
+++ b/styleguide/content-planning.md
@@ -1,5 +1,6 @@
---
title: Content planning - Microsoft Style Guide
+description: Discusses content planning and how great content starts with a plan that begins with questions, such as who is your audience?
author: pallep
ms.author: pallep
ms.date: 07/31/2018
diff --git a/styleguide/design-planning.md b/styleguide/design-planning.md
index 4fbe1e48..c141dffc 100644
--- a/styleguide/design-planning.md
+++ b/styleguide/design-planning.md
@@ -1,5 +1,6 @@
---
title: Design planning - Microsoft Style Guide
+description: Discusses design planning, such as design is more than a pretty face because it provides a familiar environment for content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/developer-content/code-examples.md b/styleguide/developer-content/code-examples.md
index 5df8f168..308c2686 100644
--- a/styleguide/developer-content/code-examples.md
+++ b/styleguide/developer-content/code-examples.md
@@ -1,5 +1,6 @@
---
title: Code examples - Microsoft Style Guide
+description: Describes code examples, which illustrate how to use a programming element to implement specific functionality.
author: pallep
ms.author: pallep
ms.date: 08/7/2019
diff --git a/styleguide/developer-content/formatting-developer-text-elements.md b/styleguide/developer-content/formatting-developer-text-elements.md
index cc8a61c7..0b9dcfe0 100644
--- a/styleguide/developer-content/formatting-developer-text-elements.md
+++ b/styleguide/developer-content/formatting-developer-text-elements.md
@@ -1,5 +1,6 @@
---
title: Formatting developer text elements - Microsoft Style Guide
+description: Discusses formatting developer text elements that is consistent text formatting that helps readers locate and interpret information.
author: pallep
ms.author: pallep
ms.date: 08/8/2019
diff --git a/styleguide/developer-content/index.md b/styleguide/developer-content/index.md
index 172e7f0c..eabf4c44 100644
--- a/styleguide/developer-content/index.md
+++ b/styleguide/developer-content/index.md
@@ -1,5 +1,6 @@
---
title: Developer content - Microsoft Style Guide
+description: Discusses content for developers and IT professionals as more technical than a general audience, but the fundamentals of the Microsoft brand voice still apply.
author: pallep
ms.author: pallep
ms.date: 08/6/2019
diff --git a/styleguide/developer-content/reference-documentation.md b/styleguide/developer-content/reference-documentation.md
index 3d87ec2e..506dc881 100644
--- a/styleguide/developer-content/reference-documentation.md
+++ b/styleguide/developer-content/reference-documentation.md
@@ -1,5 +1,6 @@
---
title: Reference documentation - Microsoft Style Guide
+description: Discusses reference documentation as providing details about the programming elements associated with technologies and languages, including class libraries.
author: pallep
ms.author: pallep
ms.date: 08/7/2019
From 5af341830b618e74e079596af596133d6dcde94d Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Mon, 6 Jun 2022 18:22:05 -0500
Subject: [PATCH 240/486] fixing missing descriptions-cc2
---
styleguide/chatbots-virtual-agents/index.md | 2 +-
styleguide/developer-content/reference-documentation.md | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/chatbots-virtual-agents/index.md b/styleguide/chatbots-virtual-agents/index.md
index 0746a859..159a0db0 100644
--- a/styleguide/chatbots-virtual-agents/index.md
+++ b/styleguide/chatbots-virtual-agents/index.md
@@ -33,5 +33,5 @@ This section includes guidelines and tips to help you create this type of bot:
**Learn more**
[Microsoft's AI vision, rooted in research, conversations](https://news.microsoft.com/features/microsofts-ai-vision-rooted-in-research-conversations/#yAYKtrYjvRHKCYmc.97)
-[Bot Framework documentation](https://docs.microsoft.com/bot-framework/)
+[Bot Framework documentation](/bot-framework)
[Responsible bots: 10 guidelines for developers of conversational AI](https://www.microsoft.com/en-us/research/publication/responsible-bots/)
diff --git a/styleguide/developer-content/reference-documentation.md b/styleguide/developer-content/reference-documentation.md
index 506dc881..df9b8bef 100644
--- a/styleguide/developer-content/reference-documentation.md
+++ b/styleguide/developer-content/reference-documentation.md
@@ -51,7 +51,7 @@ articles. Sections vary depending on the language, product, or technology being
| **Declaration/syntax** | The code signature that defines the element. This section might also provide usage syntax. If the technology can be used with multiple programming languages, provide syntax for each language. **Example** `Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)` |
| **Parameters** | If the element has parameters, provide a description of each parameter and its data type. If appropriate, indicate whether the parameter is required or optional and whether it represents input or output. Provide as much useful detail as possible. Don't just repeat the words in the parameter name or the data type. **Examples** *Source* Optional. A **String** value that contains a URL identifying the **Record** to be moved. If *Source* is omitted or specifies an empty string, the object represented by this **Record** is moved. For example, if the **Record** represents a file, the contents of the file are moved to the location specified by *Destination.*
*Destination* Optional. A **String** value that contains a URL specifying the location where *Source* will be moved.
*UserName* Optional. A **String** value that contains the user ID that, if needed, authorizes access to *Destination.*
*Password* Optional. A **String** that contains the password that, if needed, verifies *UserName.*
*Options* Optional. A **MoveRecordOptionsEnum** value whose default value is **adMoveUnspecified**. Specifies the behavior of this method.
*Async* Optional. A **Boolean** value that, when **True**, specifies this operation should be asynchronous. |
| **Return value** | If the element returns a value, describe the value and information about its data type. If the value is a Boolean that indicates the presence of a condition, describe the condition. **Example** A **String** value. Typically, the value of *Destination* is returned. However, the exact value returned is provider-dependent. |
-| **Remarks** | Additional information about the element and important details that may not be obvious from its syntax, parameters, or return value. For example, you might explain what the element does in more detail, compare it with similar elements, and identify potential issues in its use. **Example** The values of *Source* and *Destination* must not be identical; otherwise, a runtime error occurs. At least the server, path, and resource names must differ.
For files moved using the Internet Publishing Provider, this method updates all hypertext links in files being moved unless otherwise specified by *Options.* This method fails if *Destination* identifies an existing object (for example, a file or directory), unless **adMoveOverWrite** is specified.
**Note** Use the **adMoveOverWrite** option judiciously. For example, specifying this option when moving a file to a directory will delete the directory and replace it with the file.
Certain attributes of the **Record** object, such as the **ParentURL** property, won't be updated after this operation completes. Refresh the **Record** object's properties by closing the **Record**, then reopening it with the URL of the location where the file or directory was moved.
If this **Record** was obtained from a **Recordset**, the new location of the moved file or directory won't be reflected immediately in the **Recordset**. Refresh the **Recordset** by closing and reopening it.
**Note** URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. For more information, see [Absolute and Relative URLs](https://docs.microsoft.com/sql/ado/guide/data/absolute-and-relative-urls?view=sql-server-2017). |
+| **Remarks** | Additional information about the element and important details that may not be obvious from its syntax, parameters, or return value. For example, you might explain what the element does in more detail, compare it with similar elements, and identify potential issues in its use. **Example** The values of *Source* and *Destination* must not be identical; otherwise, a runtime error occurs. At least the server, path, and resource names must differ.
For files moved using the Internet Publishing Provider, this method updates all hypertext links in files being moved unless otherwise specified by *Options.* This method fails if *Destination* identifies an existing object (for example, a file or directory), unless **adMoveOverWrite** is specified.
**Note** Use the **adMoveOverWrite** option judiciously. For example, specifying this option when moving a file to a directory will delete the directory and replace it with the file.
Certain attributes of the **Record** object, such as the **ParentURL** property, won't be updated after this operation completes. Refresh the **Record** object's properties by closing the **Record**, then reopening it with the URL of the location where the file or directory was moved.
If this **Record** was obtained from a **Recordset**, the new location of the moved file or directory won't be reflected immediately in the **Recordset**. Refresh the **Recordset** by closing and reopening it.
**Note** URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. For more information, see [Absolute and Relative URLs](/sql/ado/guide/data/absolute-and-relative-urls). |
| **Example** | A code example that illustrates how to use the programming element. For more information about writing useful code examples, see [Code examples](./code-examples.md). |
| **Requirements or Applies to** | Language or platform requirements for using the element. **Example** Record Object (ADO) |
| **See also** | References or links to more information about how to use the element. References or links to related elements. **Examples** Move Method (ADO) MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (ADO) MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (RDS) |
@@ -72,4 +72,4 @@ If you automatically generate reference documentation and comments from the sour
quality and appropriateness of the comments. Developers might leave out details that are important to
customers. Remove any implementation or internal details that aren't suitable for documentation.
-**Learn more** For other examples of technical reference articles, see the [.NET API Browser](https://docs.microsoft.com/dotnet/api/?view=netframework-4.7.1) section of [Microsoft Docs](https://docs.microsoft.com/).
+**Learn more** For other examples of technical reference articles, see the [.NET API Browser](/dotnet/api/?view=netframework-4.7.1&preserve-view=true) section of [Microsoft Docs](/documentation).
From 3e744f1641d23f8c7fd1e293664b41a9ce1392d5 Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Mon, 6 Jun 2022 21:41:13 -0500
Subject: [PATCH 241/486] [Bulk] Validation: Fixing missing descriptions-cc3
---
styleguide/final-publishing-review.md | 1 +
styleguide/global-communications/art.md | 1 +
styleguide/global-communications/examples-scenarios.md | 1 +
styleguide/global-communications/index.md | 1 +
styleguide/global-communications/names-contact-information.md | 1 +
styleguide/global-communications/time-place.md | 1 +
.../global-communications/web-software-html-considerations.md | 1 +
styleguide/global-communications/writing-tips.md | 1 +
styleguide/grammar/dangling-misplaced-modifiers.md | 1 +
styleguide/grammar/grammar-and-parts-of-speech.md | 1 +
styleguide/grammar/ing-words.md | 1 +
styleguide/grammar/nouns-pronouns.md | 1 +
styleguide/grammar/person.md | 1 +
styleguide/grammar/prepositions.md | 1 +
styleguide/grammar/verbs.md | 1 +
styleguide/numbers.md | 1 +
.../describing-alternative-input-methods.md | 1 +
.../procedures-instructions/formatting-text-in-instructions.md | 1 +
styleguide/punctuation/apostrophes.md | 1 +
styleguide/punctuation/commas.md | 1 +
styleguide/punctuation/dashes-hyphens/emes.md | 1 +
styleguide/punctuation/dashes-hyphens/enes.md | 1 +
styleguide/punctuation/dashes-hyphens/index.md | 1 +
styleguide/punctuation/exclamation-points.md | 1 +
styleguide/punctuation/formatting-punctuation.md | 1 +
25 files changed, 25 insertions(+)
diff --git a/styleguide/final-publishing-review.md b/styleguide/final-publishing-review.md
index ff1ee1a5..afbef4f7 100644
--- a/styleguide/final-publishing-review.md
+++ b/styleguide/final-publishing-review.md
@@ -1,5 +1,6 @@
---
title: Final publishing review - Microsoft Style Guide
+description: The final publishing review uses tips to help you edit like a pro, so your final content and design shine.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/art.md b/styleguide/global-communications/art.md
index 3487e748..b1df4fa8 100644
--- a/styleguide/global-communications/art.md
+++ b/styleguide/global-communications/art.md
@@ -1,5 +1,6 @@
---
title: Art - Microsoft Style Guide
+description: Instructs to use guidelines for Art to create or choose images that are helpful, legal, and inoffensive throughout the world.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/examples-scenarios.md b/styleguide/global-communications/examples-scenarios.md
index 96db88d2..dcb0f16b 100644
--- a/styleguide/global-communications/examples-scenarios.md
+++ b/styleguide/global-communications/examples-scenarios.md
@@ -1,5 +1,6 @@
---
title: Examples and scenarios - Microsoft Style Guide
+description: Discusses fictitious examples and scenarios that include the names of people, places, or organizations that are potentially sensitive.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/index.md b/styleguide/global-communications/index.md
index deeae896..49e99fff 100644
--- a/styleguide/global-communications/index.md
+++ b/styleguide/global-communications/index.md
@@ -1,5 +1,6 @@
---
title: Global communications - Microsoft Style Guide
+description: Discusses global communications and Microsoft customers who live and work all over the world and speak a variety of languages.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/names-contact-information.md b/styleguide/global-communications/names-contact-information.md
index 1a7e2d9d..33485454 100644
--- a/styleguide/global-communications/names-contact-information.md
+++ b/styleguide/global-communications/names-contact-information.md
@@ -1,5 +1,6 @@
---
title: Names and contact information - Microsoft Style Guide
+description: Discusses creating a real or sample form that collects personal information using guidelines, such as names and contact information.
author: pallep
ms.author: pallep
ms.date: 05/6/2019
diff --git a/styleguide/global-communications/time-place.md b/styleguide/global-communications/time-place.md
index b3004125..90e62d5a 100644
--- a/styleguide/global-communications/time-place.md
+++ b/styleguide/global-communications/time-place.md
@@ -1,5 +1,6 @@
---
title: Time and place - Microsoft Style Guide
+description: Instructs to use guidelines, such as dates, seasons and places, when talking about time and place.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/web-software-html-considerations.md b/styleguide/global-communications/web-software-html-considerations.md
index 95658a55..4bb3e58c 100644
--- a/styleguide/global-communications/web-software-html-considerations.md
+++ b/styleguide/global-communications/web-software-html-considerations.md
@@ -1,5 +1,6 @@
---
title: Web, software, and HTML considerations - Microsoft Style Guide
+description: Discusses web, software, and HTML considerations regarding web content that attracts a worldwide audience.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/global-communications/writing-tips.md b/styleguide/global-communications/writing-tips.md
index 699db070..e440464a 100644
--- a/styleguide/global-communications/writing-tips.md
+++ b/styleguide/global-communications/writing-tips.md
@@ -1,5 +1,6 @@
---
title: Writing tips - Microsoft Style Guide
+description: Discusses content, such as writing tips, that's easy to read and tends to be easy to localize and translate.
author: pallep
ms.author: pallep
ms.date: 07/06/2021
diff --git a/styleguide/grammar/dangling-misplaced-modifiers.md b/styleguide/grammar/dangling-misplaced-modifiers.md
index 32590370..2ebf4386 100644
--- a/styleguide/grammar/dangling-misplaced-modifiers.md
+++ b/styleguide/grammar/dangling-misplaced-modifiers.md
@@ -1,5 +1,6 @@
---
title: Dangling and misplaced modifiers - Microsoft Style Guide
+description: Discusses dangling and misplaced modifiers and modifiers that are single words or phrases that modify other words or phrases.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/grammar/grammar-and-parts-of-speech.md b/styleguide/grammar/grammar-and-parts-of-speech.md
index 278aeefe..1584ff7f 100644
--- a/styleguide/grammar/grammar-and-parts-of-speech.md
+++ b/styleguide/grammar/grammar-and-parts-of-speech.md
@@ -1,5 +1,6 @@
---
title: Grammar and parts of speech - Microsoft Style Guide
+description: Discusses simple grammar which tends to be easy to read and understand, like a conversation, which is probably just right for most Microsoft content.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/grammar/ing-words.md b/styleguide/grammar/ing-words.md
index 048272c1..a72a2f65 100644
--- a/styleguide/grammar/ing-words.md
+++ b/styleguide/grammar/ing-words.md
@@ -1,5 +1,6 @@
---
title: Words ending in -ing - Microsoft Style Guide
+description: Discusses words ending in -ing, which can be a verb, a noun, or an adjective. The sentence should make it clear which role the word plays.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index 2f420eae..bf829452 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -1,5 +1,6 @@
---
title: Nouns and pronouns - Microsoft Style Guide
+description: Discusses proper nouns, which are one of a kind—unique people, places, and things. Capitalize proper nouns wherever they occur.
author: pallep
ms.author: pallep
ms.date: 09/13/2019
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index ca53a9df..3a2ca946 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -1,5 +1,6 @@
---
title: Person - Microsoft Style Guide
+description: Discusses that in grammar, person refers to the point of view represented by a statement and determines which pronoun to use.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/grammar/prepositions.md b/styleguide/grammar/prepositions.md
index 283c890b..981ea35f 100644
--- a/styleguide/grammar/prepositions.md
+++ b/styleguide/grammar/prepositions.md
@@ -1,5 +1,6 @@
---
title: Prepositions - Microsoft Style Guide
+description: Discusses a prepositional phrase, which is a combination of a preposition and a noun that modifies or describes some part of a sentence.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/grammar/verbs.md b/styleguide/grammar/verbs.md
index 7ccbde3e..7c970f9c 100644
--- a/styleguide/grammar/verbs.md
+++ b/styleguide/grammar/verbs.md
@@ -1,5 +1,6 @@
---
title: Verbs - Microsoft Style Guide
+description: Discusses that using precise verbs, such as verb tense, in the right way helps you write clear and simple sentences.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/numbers.md b/styleguide/numbers.md
index 82e47997..01eee1c7 100644
--- a/styleguide/numbers.md
+++ b/styleguide/numbers.md
@@ -1,5 +1,6 @@
---
title: Numbers - Microsoft Style Guide
+description: Discusses being consistent in your use of numbers. When you write about numbers used in examples or UI, duplicate them exactly as they appear in the UI.
author: pallep
ms.author: pallep
ms.date: 05/13/2022
diff --git a/styleguide/procedures-instructions/describing-alternative-input-methods.md b/styleguide/procedures-instructions/describing-alternative-input-methods.md
index 1ca71919..7a953d5a 100644
--- a/styleguide/procedures-instructions/describing-alternative-input-methods.md
+++ b/styleguide/procedures-instructions/describing-alternative-input-methods.md
@@ -1,5 +1,6 @@
---
title: Describing alternative input methods - Microsoft Style Guide
+description: Discusses using input-neutral methods in instructions and providing an article that explains how to interact with the product using each available input method.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md
index 085f5dd3..e92bc5e1 100644
--- a/styleguide/procedures-instructions/formatting-text-in-instructions.md
+++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md
@@ -1,5 +1,6 @@
---
title: Formatting text in instructions - Microsoft Style Guide
+description: Discusses that consistent text formatting helps readers locate and interpret information, such as instructions.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/punctuation/apostrophes.md b/styleguide/punctuation/apostrophes.md
index 5de215de..6beb0681 100644
--- a/styleguide/punctuation/apostrophes.md
+++ b/styleguide/punctuation/apostrophes.md
@@ -1,5 +1,6 @@
---
title: Apostrophes - Microsoft Style Guide
+description: Instructs to use an apostrophe to form the possessive case of nouns. To form the possessive of plural nouns that end in s, add only an apostrophe.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/commas.md b/styleguide/punctuation/commas.md
index 68d57257..2c64c03b 100644
--- a/styleguide/punctuation/commas.md
+++ b/styleguide/punctuation/commas.md
@@ -1,5 +1,6 @@
---
title: Commas - Microsoft Style Guide
+description: Instructs to use a comma before the conjunction in a list of three or more items. (The comma that comes before the conjunction is the Oxford or serial comma.)
author: pallep
ms.author: pallep
ms.date: 03/11/2019
diff --git a/styleguide/punctuation/dashes-hyphens/emes.md b/styleguide/punctuation/dashes-hyphens/emes.md
index d0a1d8f8..141a1af7 100644
--- a/styleguide/punctuation/dashes-hyphens/emes.md
+++ b/styleguide/punctuation/dashes-hyphens/emes.md
@@ -1,5 +1,6 @@
---
title: Em dashes - Microsoft Style Guide
+description: Instructs to use an em dash (-) to set off a parenthetical phrase with more emphasis than parenthesis provide. Don't add spaces around a em dash.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/dashes-hyphens/enes.md b/styleguide/punctuation/dashes-hyphens/enes.md
index 7c26ea7d..7ded2745 100644
--- a/styleguide/punctuation/dashes-hyphens/enes.md
+++ b/styleguide/punctuation/dashes-hyphens/enes.md
@@ -1,5 +1,6 @@
---
title: En dashes - Microsoft Style Guide
+description: Instructs to use en dashes to indicate a range of numbers, such as inclusive values, dates, or pages.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/dashes-hyphens/index.md b/styleguide/punctuation/dashes-hyphens/index.md
index eec1e9de..f3c3cfe0 100644
--- a/styleguide/punctuation/dashes-hyphens/index.md
+++ b/styleguide/punctuation/dashes-hyphens/index.md
@@ -1,5 +1,6 @@
---
title: Dashes and hyphens - Microsoft Style Guide
+description: Discusses that dashes and hyphens are interchangeable, but to use them the right way, in the right places, following guidelines.
author: pallep
ms.author: pallep
ms.date: 09/8/2019
diff --git a/styleguide/punctuation/exclamation-points.md b/styleguide/punctuation/exclamation-points.md
index 1b3bf824..b2352516 100644
--- a/styleguide/punctuation/exclamation-points.md
+++ b/styleguide/punctuation/exclamation-points.md
@@ -1,5 +1,6 @@
---
title: Exclamation points - Microsoft Style Guide
+description: Instructs to use exclamation points sparingly and to save them for when they count.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/formatting-punctuation.md b/styleguide/punctuation/formatting-punctuation.md
index 3c0c105b..bef8ccd4 100644
--- a/styleguide/punctuation/formatting-punctuation.md
+++ b/styleguide/punctuation/formatting-punctuation.md
@@ -1,5 +1,6 @@
---
title: Formatting punctuation - Microsoft Style Guide
+description: Instructs that in general, format punctuation in the same font style as the main content of a sentence or phrase.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From b04cfcda83d650c63fa5097e5b7a9d78e85e19e5 Mon Sep 17 00:00:00 2001
From: cancard587 <101152181+ccard587@users.noreply.github.com>
Date: Tue, 7 Jun 2022 19:49:39 -0500
Subject: [PATCH 242/486] [Bulk] Validation: Fixing missing descriptions-cc4
---
styleguide/punctuation/index.md | 1 +
styleguide/punctuation/question-marks.md | 1 +
styleguide/punctuation/quotation-marks.md | 1 +
styleguide/punctuation/semicolons.md | 1 +
styleguide/punctuation/slashes.md | 1 +
styleguide/responsive-content.md | 1 +
styleguide/scannable-content/index.md | 1 +
styleguide/scannable-content/lists.md | 1 +
styleguide/scannable-content/tables.md | 1 +
styleguide/search-writing.md | 1 +
styleguide/text-formatting/formatting-common-text-elements.md | 1 +
styleguide/text-formatting/formatting-titles.md | 1 +
styleguide/text-formatting/index.md | 1 +
.../text-formatting/using-type/dont-compress-line-spacing.md | 1 +
styleguide/text-formatting/using-type/index.md | 1 +
styleguide/text-formatting/using-type/use-left-alignment.md | 1 +
.../using-type/use-sentence-style-capitalization.md | 1 +
styleguide/top-10-tips-style-voice.md | 1 +
styleguide/urls-web-addresses.md | 1 +
styleguide/word-choice/avoid-jargon.md | 1 +
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 1 +
styleguide/word-choice/index.md | 1 +
styleguide/word-choice/use-contractions.md | 1 +
styleguide/word-choice/use-simple-words-concise-sentences.md | 1 +
styleguide/word-choice/use-technical-terms-carefully.md | 1 +
.../word-choice/use-us-spelling-avoid-non-english-words.md | 1 +
26 files changed, 26 insertions(+)
diff --git a/styleguide/punctuation/index.md b/styleguide/punctuation/index.md
index 0defe156..a17525b2 100644
--- a/styleguide/punctuation/index.md
+++ b/styleguide/punctuation/index.md
@@ -1,5 +1,6 @@
---
title: Punctuation - Microsoft Style Guide
+description: Discusses that punctuation provides vital clues for reader understanding and is governed by well-documented rules.
author: pallep
ms.author: pallep
ms.date: 09/8/2019
diff --git a/styleguide/punctuation/question-marks.md b/styleguide/punctuation/question-marks.md
index cc6cbf83..7c5bc72b 100644
--- a/styleguide/punctuation/question-marks.md
+++ b/styleguide/punctuation/question-marks.md
@@ -1,5 +1,6 @@
---
title: Question marks - Microsoft Style Guide
+description: Instructs us to use questions and question marks sparingly. In general, customers want us to give them answers unless they need to make a decision.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/quotation-marks.md b/styleguide/punctuation/quotation-marks.md
index df6ef450..4b98d132 100644
--- a/styleguide/punctuation/quotation-marks.md
+++ b/styleguide/punctuation/quotation-marks.md
@@ -1,5 +1,6 @@
---
title: Quotation marks - Microsoft Style Guide
+description: Discusses that in most content, use double quotation marks (" ") not single quotation marks (' '). In online content, use straight quotation marks.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/semicolons.md b/styleguide/punctuation/semicolons.md
index b48df3e2..63eb2235 100644
--- a/styleguide/punctuation/semicolons.md
+++ b/styleguide/punctuation/semicolons.md
@@ -1,5 +1,6 @@
---
title: Semicolons - Microsoft Style Guide
+description: Discusses that sentences that contain semicolons are often complex. Simplify the sentence—break it into multiple sentences or a list—to eliminate the semicolon.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/punctuation/slashes.md b/styleguide/punctuation/slashes.md
index fcdff19c..23406806 100644
--- a/styleguide/punctuation/slashes.md
+++ b/styleguide/punctuation/slashes.md
@@ -1,5 +1,6 @@
---
title: Slashes - Microsoft Style Guide
+description: Instructs that when necessary, differentiate between a slash for URLs and a backslash for servers and folders.
author: pallep
ms.author: pallep
ms.date: 09/5/2019
diff --git a/styleguide/responsive-content.md b/styleguide/responsive-content.md
index e2c82cc2..8e12afd1 100644
--- a/styleguide/responsive-content.md
+++ b/styleguide/responsive-content.md
@@ -1,5 +1,6 @@
---
title: Responsive content - Microsoft Style Guide
+description: Discusses that if you’re writing for the web, assume your content will be used on a variety of devices. Many websites today are responsive.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/scannable-content/index.md b/styleguide/scannable-content/index.md
index e25099a3..0f01e0b9 100644
--- a/styleguide/scannable-content/index.md
+++ b/styleguide/scannable-content/index.md
@@ -1,5 +1,6 @@
---
title: Scannable content - Microsoft Style Guide
+description: Describes scannable content and that the volume of content available to customers is overwhelming.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/scannable-content/lists.md b/styleguide/scannable-content/lists.md
index 6681f0ab..894ebfb5 100644
--- a/styleguide/scannable-content/lists.md
+++ b/styleguide/scannable-content/lists.md
@@ -1,5 +1,6 @@
---
title: Lists - Microsoft Style Guide
+description: Discusses lists, which are a great way to present complex text in a way that's easy to scan. A list should have at least two items but no more than seven items.
author: pallep
ms.author: pallep
ms.date: 08/09/2021
diff --git a/styleguide/scannable-content/tables.md b/styleguide/scannable-content/tables.md
index 69105fb2..82265598 100644
--- a/styleguide/scannable-content/tables.md
+++ b/styleguide/scannable-content/tables.md
@@ -1,5 +1,6 @@
---
title: Tables - Microsoft Style Guide
+description: Discusses tables, which make complex information easier to understand by presenting it in a clear structure.
author: pallep
ms.author: pallep
ms.date: 10/6/2018
diff --git a/styleguide/search-writing.md b/styleguide/search-writing.md
index b04ddf02..2c2ce336 100644
--- a/styleguide/search-writing.md
+++ b/styleguide/search-writing.md
@@ -1,5 +1,6 @@
---
title: Search and writing - Microsoft Style Guide
+description: Customers find content in a variety of ways, such as search, but good writing that addresses customer needs always helps.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/text-formatting/formatting-common-text-elements.md b/styleguide/text-formatting/formatting-common-text-elements.md
index e7b98202..1897960a 100644
--- a/styleguide/text-formatting/formatting-common-text-elements.md
+++ b/styleguide/text-formatting/formatting-common-text-elements.md
@@ -1,5 +1,6 @@
---
title: Formatting common text elements - Microsoft Style Guide
+description: Discusses that consistent text formatting helps readers locate and interpret information. Follow formatting conventions, such as bold, for common text elements.
author: pallep
ms.author: pallep
ms.date: 02/1/2019
diff --git a/styleguide/text-formatting/formatting-titles.md b/styleguide/text-formatting/formatting-titles.md
index 1964abc5..76b62e93 100644
--- a/styleguide/text-formatting/formatting-titles.md
+++ b/styleguide/text-formatting/formatting-titles.md
@@ -1,5 +1,6 @@
---
title: Formatting titles - Microsoft Style Guide
+description: Instructs to follow conventions, such as title-style capitalization and italics, for formatting titles, like games and books.
author: pallep
ms.author: pallep
ms.date: 02/07/2018
diff --git a/styleguide/text-formatting/index.md b/styleguide/text-formatting/index.md
index ac7366b3..2bd8ad28 100644
--- a/styleguide/text-formatting/index.md
+++ b/styleguide/text-formatting/index.md
@@ -1,5 +1,6 @@
---
title: Text formatting - Microsoft Style Guide
+description: Discusses consistent formatting of text elements, such as command names and URLs, reduces ambiguity and helps customers find and interpret information easily.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/text-formatting/using-type/dont-compress-line-spacing.md b/styleguide/text-formatting/using-type/dont-compress-line-spacing.md
index b73ff9af..5284adde 100644
--- a/styleguide/text-formatting/using-type/dont-compress-line-spacing.md
+++ b/styleguide/text-formatting/using-type/dont-compress-line-spacing.md
@@ -1,5 +1,6 @@
---
title: Don't compress line spacing - Microsoft Style Guide
+description: Discusses that the amount of vertical space between lines of text in a paragraph, called line spacing, can help or hinder reading.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/text-formatting/using-type/index.md b/styleguide/text-formatting/using-type/index.md
index 59da4f1a..7f4f6a56 100644
--- a/styleguide/text-formatting/using-type/index.md
+++ b/styleguide/text-formatting/using-type/index.md
@@ -1,5 +1,6 @@
---
title: Using type - Microsoft Style Guide
+description: Discusses using type and that beautiful typography is a cornerstone of modern design. Guidelines, such as using left alignment, is a guideline to achieve it.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/text-formatting/using-type/use-left-alignment.md b/styleguide/text-formatting/using-type/use-left-alignment.md
index 00460a0a..931c4145 100644
--- a/styleguide/text-formatting/using-type/use-left-alignment.md
+++ b/styleguide/text-formatting/using-type/use-left-alignment.md
@@ -1,5 +1,6 @@
---
title: Use left alignment - Microsoft Style Guide
+description: Instructs to use left-aligned text, which has an even left margin and an erratic (ragged) right margin.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md b/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md
index ce61d818..06888c7a 100644
--- a/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md
+++ b/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md
@@ -1,5 +1,6 @@
---
title: Use sentence-style capitalization - Microsoft Style Guide
+description: Instructs to use sentence-style capitalization in which you capitalize only the first word of a sentence or phrase and proper nouns.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/top-10-tips-style-voice.md b/styleguide/top-10-tips-style-voice.md
index 12ced04d..b7883e80 100644
--- a/styleguide/top-10-tips-style-voice.md
+++ b/styleguide/top-10-tips-style-voice.md
@@ -1,5 +1,6 @@
---
title: Top 10 tips for Microsoft style and voice - Microsoft Style Guide
+description: Instructs to use bigger ideas, fewer words, write like you speak, project friendliness and get to the point fast.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/urls-web-addresses.md b/styleguide/urls-web-addresses.md
index 6671df8b..fcd12e55 100644
--- a/styleguide/urls-web-addresses.md
+++ b/styleguide/urls-web-addresses.md
@@ -1,5 +1,6 @@
---
title: URLs and web addresses - Microsoft Style Guide
+description: Discusses that communications to customers often refer to websites and URLs. In content for a general audience, use address rather than URL.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/word-choice/avoid-jargon.md b/styleguide/word-choice/avoid-jargon.md
index c796cdfc..10d74647 100644
--- a/styleguide/word-choice/avoid-jargon.md
+++ b/styleguide/word-choice/avoid-jargon.md
@@ -1,5 +1,6 @@
---
title: Avoid jargon - Microsoft Style Guide
+description: Instructs to avoid jargon, but in the right context, for a particular audience, jargon serves as shorthand for well-understood concepts.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index 36d688c3..e71d57d2 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -1,5 +1,6 @@
---
title: Don't use common words in new ways - Microsoft Style Guide
+description: Instructs not to use common words in new ways, such as bucketize to mean group, and to be careful with common words that have industry-specific uses.
author: pallep
ms.author: pallep
ms.date: 08/25/2021
diff --git a/styleguide/word-choice/index.md b/styleguide/word-choice/index.md
index 94da9a4c..46f8adee 100644
--- a/styleguide/word-choice/index.md
+++ b/styleguide/word-choice/index.md
@@ -1,5 +1,6 @@
---
title: Word choice - Microsoft Style Guide
+description: Instructs that to improve readability and comprehension, choose your words wisely and use them consistently. If you mean the same thing, use the same word.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/word-choice/use-contractions.md b/styleguide/word-choice/use-contractions.md
index b1a526fd..00a0e635 100644
--- a/styleguide/word-choice/use-contractions.md
+++ b/styleguide/word-choice/use-contractions.md
@@ -1,5 +1,6 @@
---
title: Use contractions - Microsoft Style Guide
+description: Instructs to write using the same, everyday words you use in conversation. Use common contractions, such as it’s, to create a friendly, informal tone.
author: pallep
ms.author: pallep
ms.date: 08/23/2019
diff --git a/styleguide/word-choice/use-simple-words-concise-sentences.md b/styleguide/word-choice/use-simple-words-concise-sentences.md
index b96eeaeb..b2851b83 100644
--- a/styleguide/word-choice/use-simple-words-concise-sentences.md
+++ b/styleguide/word-choice/use-simple-words-concise-sentences.md
@@ -1,5 +1,6 @@
---
title: Use simple words, concise sentences - Microsoft Style Guide
+description: Instructs to make every word count. Concise, clear sentences save space, are easy to understand, and facilitate scanning.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/word-choice/use-technical-terms-carefully.md b/styleguide/word-choice/use-technical-terms-carefully.md
index 29440cbd..243fc1ad 100644
--- a/styleguide/word-choice/use-technical-terms-carefully.md
+++ b/styleguide/word-choice/use-technical-terms-carefully.md
@@ -1,5 +1,6 @@
---
title: Use technical terms carefully - Microsoft Style Guide
+description: Instructs to use technical terms carefully. Use them when they're the clearest way to communicate your message, but don't use them when an everyday term will do.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/word-choice/use-us-spelling-avoid-non-english-words.md b/styleguide/word-choice/use-us-spelling-avoid-non-english-words.md
index 8fc6b504..a023e010 100644
--- a/styleguide/word-choice/use-us-spelling-avoid-non-english-words.md
+++ b/styleguide/word-choice/use-us-spelling-avoid-non-english-words.md
@@ -1,5 +1,6 @@
---
title: Use US spelling and avoid non-English words - Microsoft Style Guide
+description: Instructs to use US spelling and avoid non-English words. When the spelling of English words varies by locale, use the US spelling.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From ea2e496d50aef59861b1bddd2f167e6f326cf9b0 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Tue, 7 Jun 2022 22:47:40 -0400
Subject: [PATCH 243/486] [Bulk] Validation Fixes
---
styleguide/a-z-word-list-term-collections/b/back-end.md | 5 +++--
.../a-z-word-list-term-collections/b/back-up-backup.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/backbone.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/backlight.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/backspace.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/backtab.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/badge.md | 8 ++++----
styleguide/a-z-word-list-term-collections/b/baseline.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/baud.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/beep.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/below.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/beta.md | 3 ++-
styleguide/a-z-word-list-term-collections/b/bi.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/big-data.md | 1 +
.../b/big-endian-little-endian.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/billion-b.md | 5 +++--
styleguide/a-z-word-list-term-collections/b/bio.md | 9 +++++----
styleguide/a-z-word-list-term-collections/b/bitmap.md | 5 +++--
.../a-z-word-list-term-collections/b/bits-per-second.md | 3 ++-
styleguide/a-z-word-list-term-collections/b/black-box.md | 5 +++--
.../a-z-word-list-term-collections/b/black-hat-hacker.md | 5 +++--
21 files changed, 62 insertions(+), 42 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/b/back-end.md b/styleguide/a-z-word-list-term-collections/b/back-end.md
index 8b65e843..73d4663f 100644
--- a/styleguide/a-z-word-list-term-collections/b/back-end.md
+++ b/styleguide/a-z-word-list-term-collections/b/back-end.md
@@ -1,5 +1,6 @@
---
-title: back end, back-end - Microsoft Style Guide
+title: Back End, Back-End - Microsoft Style Guide
+description: This article outlines use of the term back end/back-end per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# back end, back-end
+# Back End, Back-End
Don't use if you can substitute a more specific term, such as server, operating system, database, or network.
diff --git a/styleguide/a-z-word-list-term-collections/b/back-up-backup.md b/styleguide/a-z-word-list-term-collections/b/back-up-backup.md
index 8fd81ca6..3b21e327 100644
--- a/styleguide/a-z-word-list-term-collections/b/back-up-backup.md
+++ b/styleguide/a-z-word-list-term-collections/b/back-up-backup.md
@@ -1,5 +1,6 @@
---
-title: back up, backup - Microsoft Style Guide
+title: Back Up, Backup - Microsoft Style Guide
+description: This article outlines use of the term back up/backup per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# back up, backup
+# Back Up, Backup
Two words as a verb, one word as an adjective or a noun.
diff --git a/styleguide/a-z-word-list-term-collections/b/backbone.md b/styleguide/a-z-word-list-term-collections/b/backbone.md
index 570966bf..9011a831 100644
--- a/styleguide/a-z-word-list-term-collections/b/backbone.md
+++ b/styleguide/a-z-word-list-term-collections/b/backbone.md
@@ -1,5 +1,6 @@
---
-title: backbone - Microsoft Style Guide
+title: Backbone - Microsoft Style Guide
+description: This article outlines use of the word backbone per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# backbone
+# Backbone
Don't use in content for a general audience. You don't need to define *backbone* in content for a technical audience.
diff --git a/styleguide/a-z-word-list-term-collections/b/backlight.md b/styleguide/a-z-word-list-term-collections/b/backlight.md
index 5eae7c5b..e0ffca59 100644
--- a/styleguide/a-z-word-list-term-collections/b/backlight.md
+++ b/styleguide/a-z-word-list-term-collections/b/backlight.md
@@ -1,5 +1,6 @@
---
-title: backlight - Microsoft Style Guide
+title: Backlight - Microsoft Style Guide
+description: This article outlines use of the word backlight per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# backlight
+# Backlight
One word.
diff --git a/styleguide/a-z-word-list-term-collections/b/backspace.md b/styleguide/a-z-word-list-term-collections/b/backspace.md
index 2d3fef38..720ad1cc 100644
--- a/styleguide/a-z-word-list-term-collections/b/backspace.md
+++ b/styleguide/a-z-word-list-term-collections/b/backspace.md
@@ -1,5 +1,6 @@
---
-title: backspace - Microsoft Style Guide
+title: Backspace - Microsoft Style Guide
+description: This article outlines use of the word backspace per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# backspace
+# Backspace
One word. OK to use as a verb.
diff --git a/styleguide/a-z-word-list-term-collections/b/backtab.md b/styleguide/a-z-word-list-term-collections/b/backtab.md
index bcf422f6..ac763e36 100644
--- a/styleguide/a-z-word-list-term-collections/b/backtab.md
+++ b/styleguide/a-z-word-list-term-collections/b/backtab.md
@@ -1,5 +1,6 @@
---
-title: backtab - Microsoft Style Guide
+title: Backtab - Microsoft Style Guide
+description: This article outlines use of the term backtab per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# backtab
+# Backtab
Don't use. Instead, instruct the customer to use Shift+Tab.
diff --git a/styleguide/a-z-word-list-term-collections/b/badge.md b/styleguide/a-z-word-list-term-collections/b/badge.md
index 1cddcce3..cad3decc 100644
--- a/styleguide/a-z-word-list-term-collections/b/badge.md
+++ b/styleguide/a-z-word-list-term-collections/b/badge.md
@@ -1,5 +1,6 @@
---
-title: badge - Microsoft Style Guide
+title: Badge - Microsoft Style Guide
+description: This article outlines use of the word badge per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,10 +8,9 @@ ms.topic: article
ms.prod: non-product-specific
---
-# badge
+# Badge
-A
-star, medal, or other virtual recognition that indicates an achievement
+A star, medal, or other virtual recognition that indicates an achievement
in a game or other program. Use title-style capitalization for a
badge name. Lowercase the word *badge*.
diff --git a/styleguide/a-z-word-list-term-collections/b/baseline.md b/styleguide/a-z-word-list-term-collections/b/baseline.md
index 5af5e10e..9aa67bc2 100644
--- a/styleguide/a-z-word-list-term-collections/b/baseline.md
+++ b/styleguide/a-z-word-list-term-collections/b/baseline.md
@@ -1,5 +1,6 @@
---
-title: baseline - Microsoft Style Guide
+title: Baseline - Microsoft Style Guide
+description: This article outlines use of the word baseline per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# baseline
+# Baseline
Use *baseline* (one word) to refer to an established standard, as in *baseline data*.
diff --git a/styleguide/a-z-word-list-term-collections/b/baud.md b/styleguide/a-z-word-list-term-collections/b/baud.md
index 361623b6..3c1abc85 100644
--- a/styleguide/a-z-word-list-term-collections/b/baud.md
+++ b/styleguide/a-z-word-list-term-collections/b/baud.md
@@ -1,5 +1,6 @@
---
-title: baud - Microsoft Style Guide
+title: Baud - Microsoft Style Guide
+description: This article on the unit baud links to a units of measure term collection in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# baud
+# Baud
**See** [Units of measure term collection](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md)
diff --git a/styleguide/a-z-word-list-term-collections/b/beep.md b/styleguide/a-z-word-list-term-collections/b/beep.md
index 0f129356..cde64cdd 100644
--- a/styleguide/a-z-word-list-term-collections/b/beep.md
+++ b/styleguide/a-z-word-list-term-collections/b/beep.md
@@ -1,5 +1,6 @@
---
-title: beep - Microsoft Style Guide
+title: Beep - Microsoft Style Guide
+description: This article outlines use of the word beep per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# beep
+# Beep
Use instead of *alarm* or *tone* to refer to a beeping sound.
diff --git a/styleguide/a-z-word-list-term-collections/b/below.md b/styleguide/a-z-word-list-term-collections/b/below.md
index 4e4e8d14..a0ff7b9b 100644
--- a/styleguide/a-z-word-list-term-collections/b/below.md
+++ b/styleguide/a-z-word-list-term-collections/b/below.md
@@ -1,5 +1,6 @@
---
-title: below - Microsoft Style Guide
+title: Below - Microsoft Style Guide
+description: This article outlines use of the word below per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# below
+# Below
Don't use to mean *later*.
diff --git a/styleguide/a-z-word-list-term-collections/b/beta.md b/styleguide/a-z-word-list-term-collections/b/beta.md
index f58d0572..d1d0d561 100644
--- a/styleguide/a-z-word-list-term-collections/b/beta.md
+++ b/styleguide/a-z-word-list-term-collections/b/beta.md
@@ -1,5 +1,6 @@
---
-title: beta - Microsoft Style Guide
+title: Beta - Microsoft Style Guide
+description: The word beta should be generally avoided in accordance with Microsoft style guidelines. The word preview is preferred.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bi.md b/styleguide/a-z-word-list-term-collections/b/bi.md
index f1a2878e..17b4a043 100644
--- a/styleguide/a-z-word-list-term-collections/b/bi.md
+++ b/styleguide/a-z-word-list-term-collections/b/bi.md
@@ -1,5 +1,6 @@
---
-title: bi- - Microsoft Style Guide
+title: Bi- - Microsoft Style Guide
+description: This article outlines use of the bi- prefix per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# bi-
+# Bi-
In general, don't hyphenate words beginning with *bi-,* such as *bidirectional,* *bimodal,* and *bimonthly,* unless it's necessary to avoid confusion. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
diff --git a/styleguide/a-z-word-list-term-collections/b/big-data.md b/styleguide/a-z-word-list-term-collections/b/big-data.md
index a75ea9a2..91451cba 100644
--- a/styleguide/a-z-word-list-term-collections/b/big-data.md
+++ b/styleguide/a-z-word-list-term-collections/b/big-data.md
@@ -1,5 +1,6 @@
---
title: big data - Microsoft Style Guide
+description: This article notes that the term big data should not be capitalized per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/big-endian-little-endian.md b/styleguide/a-z-word-list-term-collections/b/big-endian-little-endian.md
index 563b6cf1..62bf2855 100644
--- a/styleguide/a-z-word-list-term-collections/b/big-endian-little-endian.md
+++ b/styleguide/a-z-word-list-term-collections/b/big-endian-little-endian.md
@@ -1,5 +1,6 @@
---
-title: big-endian, little-endian - Microsoft Style Guide
+title: Big-Endian, Little-Endian - Microsoft Style Guide
+description: This article outlines use of the terms big-endian and little-endian per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# big-endian, little-endian
+# Big-Endian, Little-Endian
It’s OK to use *big-endian* and *little-endian* in content for a technical audience. *Big-endian* refers to the method of physically storing numbers so that the most significant byte is placed first. *Little-endian* is the opposite.
diff --git a/styleguide/a-z-word-list-term-collections/b/billion-b.md b/styleguide/a-z-word-list-term-collections/b/billion-b.md
index af78fb76..b74bda43 100644
--- a/styleguide/a-z-word-list-term-collections/b/billion-b.md
+++ b/styleguide/a-z-word-list-term-collections/b/billion-b.md
@@ -1,5 +1,6 @@
---
-title: billion, B - Microsoft Style Guide
+title: Billion, B - Microsoft Style Guide
+description: This article links to a resource for using the word billion in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 09/18/2019
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# billion, B
+# Billion, B
**See** [Numbers](~/numbers.md)
diff --git a/styleguide/a-z-word-list-term-collections/b/bio.md b/styleguide/a-z-word-list-term-collections/b/bio.md
index 6cd4ae70..c6534db0 100644
--- a/styleguide/a-z-word-list-term-collections/b/bio.md
+++ b/styleguide/a-z-word-list-term-collections/b/bio.md
@@ -1,5 +1,6 @@
---
-title: bio - Microsoft Style Guide
+title: Bio - Microsoft Style Guide
+description: This article outlines use of the term bio per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,11 +8,11 @@ ms.topic: article
ms.prod: non-product-specific
---
-# bio
+# Bio
OK to use as an abbreviation for *biography*.
-**Global tip** In
-many languages, the full term is translated because an abbreviation
+**Global tip**
+In many languages, the full term is translated because an abbreviation
isn't available. So you'll still need to allow ample space for expansion
in localized text.
diff --git a/styleguide/a-z-word-list-term-collections/b/bitmap.md b/styleguide/a-z-word-list-term-collections/b/bitmap.md
index 8a6496eb..a8119877 100644
--- a/styleguide/a-z-word-list-term-collections/b/bitmap.md
+++ b/styleguide/a-z-word-list-term-collections/b/bitmap.md
@@ -1,5 +1,6 @@
---
-title: bitmap - Microsoft Style Guide
+title: Bitmap - Microsoft Style Guide
+description: This article outlines use of the word bitmap per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,7 +8,7 @@ ms.topic: article
ms.prod: non-product-specific
---
-# bitmap
+# Bitmap
One word.
diff --git a/styleguide/a-z-word-list-term-collections/b/bits-per-second.md b/styleguide/a-z-word-list-term-collections/b/bits-per-second.md
index 6096914d..938f2e51 100644
--- a/styleguide/a-z-word-list-term-collections/b/bits-per-second.md
+++ b/styleguide/a-z-word-list-term-collections/b/bits-per-second.md
@@ -1,5 +1,6 @@
---
-title: bits per second - Microsoft Style Guide
+title: Bits Per Second - Microsoft Style Guide
+description: This article links to a bits and bytes term collection resource to write the term bits per second in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/black-box.md b/styleguide/a-z-word-list-term-collections/b/black-box.md
index 9b552a7f..f893b7a6 100644
--- a/styleguide/a-z-word-list-term-collections/b/black-box.md
+++ b/styleguide/a-z-word-list-term-collections/b/black-box.md
@@ -1,5 +1,6 @@
---
-title: black box - Microsoft Style Guide
+title: Black Box - Microsoft Style Guide
+description: This article outlines use of the term black box per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# black box
+# Black Box
Don't use.
diff --git a/styleguide/a-z-word-list-term-collections/b/black-hat-hacker.md b/styleguide/a-z-word-list-term-collections/b/black-hat-hacker.md
index 4b51d352..e4e36e9c 100644
--- a/styleguide/a-z-word-list-term-collections/b/black-hat-hacker.md
+++ b/styleguide/a-z-word-list-term-collections/b/black-hat-hacker.md
@@ -1,5 +1,6 @@
---
-title: black hat hacker - Microsoft Style Guide
+title: Black Hat Hacker - Microsoft Style Guide
+description: This article links to a security term collection resource to write term black hat hacker in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
@@ -7,6 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# black hat hacker
+# Black Hat Hacker
See [Security term collection](~/a-z-word-list-term-collections/term-collections/security-terms.md)
From 5b564b2a32e4ba0151ffe81885859e1c863c9f5f Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Tue, 7 Jun 2022 23:02:18 -0400
Subject: [PATCH 244/486] [Bulk] Validation Fixes
---
styleguide/a-z-word-list-term-collections/b/blade.md | 1 +
styleguide/a-z-word-list-term-collections/b/blank.md | 1 +
.../b/blog-blogger-blogroll-weblog.md | 1 +
styleguide/a-z-word-list-term-collections/b/blu-ray-disc.md | 1 +
.../a-z-word-list-term-collections/b/blue-screen-bluescreen.md | 1 +
styleguide/a-z-word-list-term-collections/b/bluetooth.md | 1 +
styleguide/a-z-word-list-term-collections/b/board.md | 1 +
styleguide/a-z-word-list-term-collections/b/bold.md | 1 +
styleguide/a-z-word-list-term-collections/b/bookmark.md | 1 +
styleguide/a-z-word-list-term-collections/b/boolean.md | 1 +
styleguide/a-z-word-list-term-collections/b/boot.md | 1 +
styleguide/a-z-word-list-term-collections/b/bot.md | 1 +
.../a-z-word-list-term-collections/b/bottom-left-bottom-right.md | 1 +
styleguide/a-z-word-list-term-collections/b/bounding-outline.md | 1 +
styleguide/a-z-word-list-term-collections/b/box.md | 1 +
styleguide/a-z-word-list-term-collections/b/bps.md | 1 +
styleguide/a-z-word-list-term-collections/b/breakpoint.md | 1 +
styleguide/a-z-word-list-term-collections/b/broadcast.md | 1 +
styleguide/a-z-word-list-term-collections/b/browse.md | 1 +
styleguide/a-z-word-list-term-collections/b/bug-fix.md | 1 +
styleguide/a-z-word-list-term-collections/b/build.md | 1 +
21 files changed, 21 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/b/blade.md b/styleguide/a-z-word-list-term-collections/b/blade.md
index 6fdafa12..b58d61e0 100644
--- a/styleguide/a-z-word-list-term-collections/b/blade.md
+++ b/styleguide/a-z-word-list-term-collections/b/blade.md
@@ -1,5 +1,6 @@
---
title: blade - Microsoft Style Guide
+description: This article outlines use of the word blade per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 02/27/2019
diff --git a/styleguide/a-z-word-list-term-collections/b/blank.md b/styleguide/a-z-word-list-term-collections/b/blank.md
index 1938cd4a..64dcabb3 100644
--- a/styleguide/a-z-word-list-term-collections/b/blank.md
+++ b/styleguide/a-z-word-list-term-collections/b/blank.md
@@ -1,5 +1,6 @@
---
title: blank - Microsoft Style Guide
+description: This article outlines use of the word blank per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/blog-blogger-blogroll-weblog.md b/styleguide/a-z-word-list-term-collections/b/blog-blogger-blogroll-weblog.md
index f3ecef72..6ffaea59 100644
--- a/styleguide/a-z-word-list-term-collections/b/blog-blogger-blogroll-weblog.md
+++ b/styleguide/a-z-word-list-term-collections/b/blog-blogger-blogroll-weblog.md
@@ -1,5 +1,6 @@
---
title: blog, blogger, blogroll, weblog - Microsoft Style Guide
+description: This article outlines use of the terms blog, blogger, blogroll, and weblog per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/blu-ray-disc.md b/styleguide/a-z-word-list-term-collections/b/blu-ray-disc.md
index d3eb263c..36019c2f 100644
--- a/styleguide/a-z-word-list-term-collections/b/blu-ray-disc.md
+++ b/styleguide/a-z-word-list-term-collections/b/blu-ray-disc.md
@@ -1,5 +1,6 @@
---
title: Blu-ray Disc - Microsoft Style Guide
+description: This article outlines use of the name Blu-ray Disc per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/blue-screen-bluescreen.md b/styleguide/a-z-word-list-term-collections/b/blue-screen-bluescreen.md
index 0131c7aa..207d767e 100644
--- a/styleguide/a-z-word-list-term-collections/b/blue-screen-bluescreen.md
+++ b/styleguide/a-z-word-list-term-collections/b/blue-screen-bluescreen.md
@@ -1,5 +1,6 @@
---
title: blue screen, bluescreen - Microsoft Style Guide
+description: This article outlines use of the term blue screen/bluescreen per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bluetooth.md b/styleguide/a-z-word-list-term-collections/b/bluetooth.md
index 97b0cdf1..ea6b1341 100644
--- a/styleguide/a-z-word-list-term-collections/b/bluetooth.md
+++ b/styleguide/a-z-word-list-term-collections/b/bluetooth.md
@@ -1,5 +1,6 @@
---
title: Bluetooth - Microsoft Style Guide
+description: This article outlines use of the name Bluetooth per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/board.md b/styleguide/a-z-word-list-term-collections/b/board.md
index d390154e..b1fda9e2 100644
--- a/styleguide/a-z-word-list-term-collections/b/board.md
+++ b/styleguide/a-z-word-list-term-collections/b/board.md
@@ -1,5 +1,6 @@
---
title: board - Microsoft Style Guide
+description: This article outlines use of the word board per Microsoft style guidelines, with an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bold.md b/styleguide/a-z-word-list-term-collections/b/bold.md
index 765236a7..3dca908d 100644
--- a/styleguide/a-z-word-list-term-collections/b/bold.md
+++ b/styleguide/a-z-word-list-term-collections/b/bold.md
@@ -1,5 +1,6 @@
---
title: bold - Microsoft Style Guide
+description: This article outlines use of the word bold per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 09/3/2019
diff --git a/styleguide/a-z-word-list-term-collections/b/bookmark.md b/styleguide/a-z-word-list-term-collections/b/bookmark.md
index 68571b59..8b50581f 100644
--- a/styleguide/a-z-word-list-term-collections/b/bookmark.md
+++ b/styleguide/a-z-word-list-term-collections/b/bookmark.md
@@ -1,5 +1,6 @@
---
title: bookmark - Microsoft Style Guide
+description: This article outlines use of the word bookmark per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/boolean.md b/styleguide/a-z-word-list-term-collections/b/boolean.md
index b5534fa5..8bbfe5f2 100644
--- a/styleguide/a-z-word-list-term-collections/b/boolean.md
+++ b/styleguide/a-z-word-list-term-collections/b/boolean.md
@@ -1,5 +1,6 @@
---
title: Boolean - Microsoft Style Guide
+description: This article outlines use of the word boolean per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/boot.md b/styleguide/a-z-word-list-term-collections/b/boot.md
index 0dae9b4e..f6b29d51 100644
--- a/styleguide/a-z-word-list-term-collections/b/boot.md
+++ b/styleguide/a-z-word-list-term-collections/b/boot.md
@@ -1,5 +1,6 @@
---
title: boot - Microsoft Style Guide
+description: This article outlines use of the word boot per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bot.md b/styleguide/a-z-word-list-term-collections/b/bot.md
index 46c790c0..2aeb314d 100644
--- a/styleguide/a-z-word-list-term-collections/b/bot.md
+++ b/styleguide/a-z-word-list-term-collections/b/bot.md
@@ -1,5 +1,6 @@
---
title: bot - Microsoft Style Guide
+description: This article links to an AI and bot term collection for using the word bot in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bottom-left-bottom-right.md b/styleguide/a-z-word-list-term-collections/b/bottom-left-bottom-right.md
index aefcaa04..3b5727b0 100644
--- a/styleguide/a-z-word-list-term-collections/b/bottom-left-bottom-right.md
+++ b/styleguide/a-z-word-list-term-collections/b/bottom-left-bottom-right.md
@@ -1,5 +1,6 @@
---
title: bottom left, bottom right - Microsoft Style Guide
+description: This article outlines use of the terms bottom left and bottom right per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bounding-outline.md b/styleguide/a-z-word-list-term-collections/b/bounding-outline.md
index 32fef4b9..9a689d4f 100644
--- a/styleguide/a-z-word-list-term-collections/b/bounding-outline.md
+++ b/styleguide/a-z-word-list-term-collections/b/bounding-outline.md
@@ -1,5 +1,6 @@
---
title: bounding outline - Microsoft Style Guide
+description: This article outlines use of the term bounding outline per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/box.md b/styleguide/a-z-word-list-term-collections/b/box.md
index 56826a10..05d623fc 100644
--- a/styleguide/a-z-word-list-term-collections/b/box.md
+++ b/styleguide/a-z-word-list-term-collections/b/box.md
@@ -1,5 +1,6 @@
---
title: box - Microsoft Style Guide
+description: This article outlines use of the word box per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/b/bps.md b/styleguide/a-z-word-list-term-collections/b/bps.md
index 57bf6383..a47e1cc8 100644
--- a/styleguide/a-z-word-list-term-collections/b/bps.md
+++ b/styleguide/a-z-word-list-term-collections/b/bps.md
@@ -1,5 +1,6 @@
---
title: bps - Microsoft Style Guide
+description: This article links to a bits and bytes term collection resource for using the term bps in accordance with Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/breakpoint.md b/styleguide/a-z-word-list-term-collections/b/breakpoint.md
index ba76542f..81fb9639 100644
--- a/styleguide/a-z-word-list-term-collections/b/breakpoint.md
+++ b/styleguide/a-z-word-list-term-collections/b/breakpoint.md
@@ -1,5 +1,6 @@
---
title: breakpoint - Microsoft Style Guide
+description: This article outlines use of the word breakpoint per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/broadcast.md b/styleguide/a-z-word-list-term-collections/b/broadcast.md
index 33bdbe85..a40d4ab6 100644
--- a/styleguide/a-z-word-list-term-collections/b/broadcast.md
+++ b/styleguide/a-z-word-list-term-collections/b/broadcast.md
@@ -1,5 +1,6 @@
---
title: broadcast - Microsoft Style Guide
+description: This article outlines use of the word broadcast per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/browse.md b/styleguide/a-z-word-list-term-collections/b/browse.md
index bd5ed9fc..58689d9d 100644
--- a/styleguide/a-z-word-list-term-collections/b/browse.md
+++ b/styleguide/a-z-word-list-term-collections/b/browse.md
@@ -1,5 +1,6 @@
---
title: browse - Microsoft Style Guide
+description: This article outlines use of the word browse per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 02/07/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/bug-fix.md b/styleguide/a-z-word-list-term-collections/b/bug-fix.md
index 01a63d0d..e1841f64 100644
--- a/styleguide/a-z-word-list-term-collections/b/bug-fix.md
+++ b/styleguide/a-z-word-list-term-collections/b/bug-fix.md
@@ -1,5 +1,6 @@
---
title: bug fix - Microsoft Style Guide
+description: This article outlines use of the term bug fix per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/build.md b/styleguide/a-z-word-list-term-collections/b/build.md
index 2c4dd5b0..5041bee8 100644
--- a/styleguide/a-z-word-list-term-collections/b/build.md
+++ b/styleguide/a-z-word-list-term-collections/b/build.md
@@ -1,5 +1,6 @@
---
title: build - Microsoft Style Guide
+description: This article outlines use of the word build per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 4b4bbe481cb4e8c061e32d1a17730bf4320604d5 Mon Sep 17 00:00:00 2001
From: AqMoh <104785314+AqMoh@users.noreply.github.com>
Date: Tue, 7 Jun 2022 23:25:11 -0400
Subject: [PATCH 245/486] [Bulk] Validation Fixes
---
styleguide/a-z-word-list-term-collections/b/bulk.md | 1 +
styleguide/a-z-word-list-term-collections/b/button.md | 1 +
styleguide/a-z-word-list-term-collections/b/by.md | 1 +
.../a-z-word-list-term-collections/c/c-cplusplus-csharp.md | 1 +
styleguide/a-z-word-list-term-collections/c/cable.md | 1 +
styleguide/a-z-word-list-term-collections/c/cabling.md | 1 +
.../a-z-word-list-term-collections/c/cache-vs-disk-cache.md | 1 +
styleguide/a-z-word-list-term-collections/c/calendar.md | 1 +
.../a-z-word-list-term-collections/c/call-back-callback.md | 1 +
styleguide/a-z-word-list-term-collections/c/call-out-callout.md | 1 +
styleguide/a-z-word-list-term-collections/c/can-may.md | 1 +
.../c/cancel-canceled-canceling-cancellation.md | 1 +
styleguide/a-z-word-list-term-collections/c/carry-out-vs-run.md | 1 +
.../c/cascading-style-sheets-css.md | 1 +
styleguide/a-z-word-list-term-collections/c/catalog.md | 1 +
styleguide/a-z-word-list-term-collections/c/category-axis.md | 1 +
.../c/cell-phone-cellular-phone.md | 1 +
styleguide/a-z-word-list-term-collections/c/cellular.md | 1 +
styleguide/a-z-word-list-term-collections/c/center-on.md | 1 +
19 files changed, 19 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/b/bulk.md b/styleguide/a-z-word-list-term-collections/b/bulk.md
index 70d3e1dc..1648273a 100644
--- a/styleguide/a-z-word-list-term-collections/b/bulk.md
+++ b/styleguide/a-z-word-list-term-collections/b/bulk.md
@@ -1,5 +1,6 @@
---
title: bulk - Microsoft Style Guide
+description: This article outlines use of the word bulk per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/button.md b/styleguide/a-z-word-list-term-collections/b/button.md
index 1cb94d91..af09acc9 100644
--- a/styleguide/a-z-word-list-term-collections/b/button.md
+++ b/styleguide/a-z-word-list-term-collections/b/button.md
@@ -1,5 +1,6 @@
---
title: button - Microsoft Style Guide
+description: This article outlines use of the word button per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/b/by.md b/styleguide/a-z-word-list-term-collections/b/by.md
index 275674f4..0eab0ce4 100644
--- a/styleguide/a-z-word-list-term-collections/b/by.md
+++ b/styleguide/a-z-word-list-term-collections/b/by.md
@@ -1,5 +1,6 @@
---
title: by (publisher or company name) - Microsoft Style Guide
+description: This article outlines use of the word by (as in publisher or company name) per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/c-cplusplus-csharp.md b/styleguide/a-z-word-list-term-collections/c/c-cplusplus-csharp.md
index deba1627..1515ac10 100644
--- a/styleguide/a-z-word-list-term-collections/c/c-cplusplus-csharp.md
+++ b/styleguide/a-z-word-list-term-collections/c/c-cplusplus-csharp.md
@@ -1,5 +1,6 @@
---
title: C, C++, C\# - Microsoft Style Guide
+description: This article outlines use of the programs C, C++, and C\# per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cable.md b/styleguide/a-z-word-list-term-collections/c/cable.md
index a9883067..708cb778 100644
--- a/styleguide/a-z-word-list-term-collections/c/cable.md
+++ b/styleguide/a-z-word-list-term-collections/c/cable.md
@@ -1,5 +1,6 @@
---
title: cable - Microsoft Style Guide
+description: This article outlines use of the word cable per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cabling.md b/styleguide/a-z-word-list-term-collections/c/cabling.md
index e2d19005..d293eeb7 100644
--- a/styleguide/a-z-word-list-term-collections/c/cabling.md
+++ b/styleguide/a-z-word-list-term-collections/c/cabling.md
@@ -1,5 +1,6 @@
---
title: cabling - Microsoft Style Guide
+description: This article outlines use of the word cabling per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cache-vs-disk-cache.md b/styleguide/a-z-word-list-term-collections/c/cache-vs-disk-cache.md
index c6e03915..0caea779 100644
--- a/styleguide/a-z-word-list-term-collections/c/cache-vs-disk-cache.md
+++ b/styleguide/a-z-word-list-term-collections/c/cache-vs-disk-cache.md
@@ -1,5 +1,6 @@
---
title: cache vs. disk cache - Microsoft Style Guide
+description: This article differentiates the words cache and disk cache and outlines their use per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/calendar.md b/styleguide/a-z-word-list-term-collections/c/calendar.md
index 922411d8..08a3fd3d 100644
--- a/styleguide/a-z-word-list-term-collections/c/calendar.md
+++ b/styleguide/a-z-word-list-term-collections/c/calendar.md
@@ -1,5 +1,6 @@
---
title: calendar - Microsoft Style Guide
+description: This article outlines use of the word calendar per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/call-back-callback.md b/styleguide/a-z-word-list-term-collections/c/call-back-callback.md
index 754ff7aa..74d7ba24 100644
--- a/styleguide/a-z-word-list-term-collections/c/call-back-callback.md
+++ b/styleguide/a-z-word-list-term-collections/c/call-back-callback.md
@@ -1,5 +1,6 @@
---
title: call back, callback - Microsoft Style Guide
+description: This article outlines use of the term call back/callback per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/call-out-callout.md b/styleguide/a-z-word-list-term-collections/c/call-out-callout.md
index ff7e30c7..b9734293 100644
--- a/styleguide/a-z-word-list-term-collections/c/call-out-callout.md
+++ b/styleguide/a-z-word-list-term-collections/c/call-out-callout.md
@@ -1,5 +1,6 @@
---
title: call out, callout - Microsoft Style Guide
+description: This article outlines use of the term call out/callout per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/can-may.md b/styleguide/a-z-word-list-term-collections/c/can-may.md
index cb82e821..d5419cfe 100644
--- a/styleguide/a-z-word-list-term-collections/c/can-may.md
+++ b/styleguide/a-z-word-list-term-collections/c/can-may.md
@@ -1,5 +1,6 @@
---
title: can, may - Microsoft Style Guide
+description: This article outlines use of the words can and may per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md b/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
index 7233ddbb..6704da00 100644
--- a/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
+++ b/styleguide/a-z-word-list-term-collections/c/cancel-canceled-canceling-cancellation.md
@@ -1,5 +1,6 @@
---
title: cancel, canceled, canceling, cancellation - Microsoft Style Guide
+description: This article outlines use of the words cancel, canceled, canceling, and cancellation per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 04/02/2021
diff --git a/styleguide/a-z-word-list-term-collections/c/carry-out-vs-run.md b/styleguide/a-z-word-list-term-collections/c/carry-out-vs-run.md
index f8a912cd..1eba6148 100644
--- a/styleguide/a-z-word-list-term-collections/c/carry-out-vs-run.md
+++ b/styleguide/a-z-word-list-term-collections/c/carry-out-vs-run.md
@@ -1,5 +1,6 @@
---
title: carry out vs. run - Microsoft Style Guide
+description: This article differentiates use of the words carry out and run per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cascading-style-sheets-css.md b/styleguide/a-z-word-list-term-collections/c/cascading-style-sheets-css.md
index 9c3d0450..a121ee7f 100644
--- a/styleguide/a-z-word-list-term-collections/c/cascading-style-sheets-css.md
+++ b/styleguide/a-z-word-list-term-collections/c/cascading-style-sheets-css.md
@@ -1,5 +1,6 @@
---
title: Cascading Style Sheets (CSS) - Microsoft Style Guide
+description: This article outlines use of the term Cascading Style Sheets (CSS) per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/catalog.md b/styleguide/a-z-word-list-term-collections/c/catalog.md
index 06959d94..b9df6bf3 100644
--- a/styleguide/a-z-word-list-term-collections/c/catalog.md
+++ b/styleguide/a-z-word-list-term-collections/c/catalog.md
@@ -1,5 +1,6 @@
---
title: catalog - Microsoft Style Guide
+description: This article outlines use of the word catalog per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/category-axis.md b/styleguide/a-z-word-list-term-collections/c/category-axis.md
index a8abc28d..8c17d816 100644
--- a/styleguide/a-z-word-list-term-collections/c/category-axis.md
+++ b/styleguide/a-z-word-list-term-collections/c/category-axis.md
@@ -1,5 +1,6 @@
---
title: category axis - Microsoft Style Guide
+description: This article outlines use of the term category axis per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cell-phone-cellular-phone.md b/styleguide/a-z-word-list-term-collections/c/cell-phone-cellular-phone.md
index d75c268e..f01d65ae 100644
--- a/styleguide/a-z-word-list-term-collections/c/cell-phone-cellular-phone.md
+++ b/styleguide/a-z-word-list-term-collections/c/cell-phone-cellular-phone.md
@@ -1,5 +1,6 @@
---
title: cell phone, cellular phone - Microsoft Style Guide
+description: This article outlines use of the word cell phone/cellular phone per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/cellular.md b/styleguide/a-z-word-list-term-collections/c/cellular.md
index bcf47b3c..fb00ea33 100644
--- a/styleguide/a-z-word-list-term-collections/c/cellular.md
+++ b/styleguide/a-z-word-list-term-collections/c/cellular.md
@@ -1,5 +1,6 @@
---
title: cellular - Microsoft Style Guide
+description: This article outlines use of the word cellular per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/c/center-on.md b/styleguide/a-z-word-list-term-collections/c/center-on.md
index 44459e1c..3c2faf11 100644
--- a/styleguide/a-z-word-list-term-collections/c/center-on.md
+++ b/styleguide/a-z-word-list-term-collections/c/center-on.md
@@ -1,5 +1,6 @@
---
title: center on - Microsoft Style Guide
+description: This article outlines use of the word center on per Microsoft style guidelines.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From f5d204a66e4a024c588d1ada84cfe6e5f6527d3f Mon Sep 17 00:00:00 2001
From: jmirabal80 <103079025+jmirabal80@users.noreply.github.com>
Date: Tue, 14 Jun 2022 11:50:39 -0600
Subject: [PATCH 246/486] Bulk Validation: fix missing descriptions
---
.../a-z-word-list-term-collections/o/on-screen-keyboard.md | 1 +
styleguide/a-z-word-list-term-collections/o/on-screen.md | 1 +
styleguide/a-z-word-list-term-collections/o/on-the-fly.md | 1 +
styleguide/a-z-word-list-term-collections/o/onto.md | 1 +
styleguide/a-z-word-list-term-collections/o/opcode.md | 1 +
styleguide/a-z-word-list-term-collections/o/open-source.md | 1 +
styleguide/a-z-word-list-term-collections/o/open.md | 1 +
.../o/operating-environment-operating-system.md | 1 +
styleguide/a-z-word-list-term-collections/o/opt-in-opt-out.md | 1 +
styleguide/a-z-word-list-term-collections/o/option-button.md | 1 +
styleguide/a-z-word-list-term-collections/o/org-organization.md | 1 +
styleguide/a-z-word-list-term-collections/o/output.md | 1 +
styleguide/a-z-word-list-term-collections/o/outside.md | 1 +
styleguide/a-z-word-list-term-collections/o/over.md | 1 +
styleguide/a-z-word-list-term-collections/o/overwrite.md | 1 +
styleguide/a-z-word-list-term-collections/p/p-code.md | 1 +
styleguide/a-z-word-list-term-collections/p/page.md | 1 +
styleguide/a-z-word-list-term-collections/p/palette.md | 1 +
styleguide/a-z-word-list-term-collections/p/pan.md | 1 +
styleguide/a-z-word-list-term-collections/p/pane.md | 1 +
styleguide/a-z-word-list-term-collections/p/parameter.md | 1 +
.../a-z-word-list-term-collections/p/parenthesis-parentheses.md | 1 +
styleguide/a-z-word-list-term-collections/p/passwordless.md | 1 +
styleguide/a-z-word-list-term-collections/p/path.md | 1 +
styleguide/a-z-word-list-term-collections/p/pc.md | 1 +
styleguide/a-z-word-list-term-collections/p/pen.md | 1 +
styleguide/a-z-word-list-term-collections/p/per.md | 1 +
.../a-z-word-list-term-collections/p/percent-percentage.md | 1 +
styleguide/a-z-word-list-term-collections/p/perimeter-network.md | 1 +
styleguide/a-z-word-list-term-collections/p/peripheral.md | 1 +
30 files changed, 30 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/o/on-screen-keyboard.md b/styleguide/a-z-word-list-term-collections/o/on-screen-keyboard.md
index d2165298..fc7b6b5d 100644
--- a/styleguide/a-z-word-list-term-collections/o/on-screen-keyboard.md
+++ b/styleguide/a-z-word-list-term-collections/o/on-screen-keyboard.md
@@ -1,5 +1,6 @@
---
title: on-screen keyboard - Microsoft Style Guide
+description: Provides a link to commonly used keys and keyboard shortcut terms including 'on-screen keyboard' for use in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/on-screen.md b/styleguide/a-z-word-list-term-collections/o/on-screen.md
index 0cd28505..1e592f10 100644
--- a/styleguide/a-z-word-list-term-collections/o/on-screen.md
+++ b/styleguide/a-z-word-list-term-collections/o/on-screen.md
@@ -1,5 +1,6 @@
---
title: on-screen - Microsoft Style Guide
+description: Describes guidelines to use 'on-screen' in Microsoft documents. Always hyphenate as an adjective or adverb.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/on-the-fly.md b/styleguide/a-z-word-list-term-collections/o/on-the-fly.md
index 1264d896..efb06df9 100644
--- a/styleguide/a-z-word-list-term-collections/o/on-the-fly.md
+++ b/styleguide/a-z-word-list-term-collections/o/on-the-fly.md
@@ -1,5 +1,6 @@
---
title: on the fly - Microsoft Style Guide
+description: Describes guidelines to use 'on the fly' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/onto.md b/styleguide/a-z-word-list-term-collections/o/onto.md
index 22a43f2b..bd03adb5 100644
--- a/styleguide/a-z-word-list-term-collections/o/onto.md
+++ b/styleguide/a-z-word-list-term-collections/o/onto.md
@@ -1,5 +1,6 @@
---
title: onto - Microsoft Style Guide
+description: Describes guidelines to use 'onto' in Microsoft documents and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/opcode.md b/styleguide/a-z-word-list-term-collections/o/opcode.md
index 2edb72de..afdee8d4 100644
--- a/styleguide/a-z-word-list-term-collections/o/opcode.md
+++ b/styleguide/a-z-word-list-term-collections/o/opcode.md
@@ -1,5 +1,6 @@
---
title: opcode - Microsoft Style Guide
+description: Describes guidelines to use 'opcode' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/open-source.md b/styleguide/a-z-word-list-term-collections/o/open-source.md
index 788f5ffb..19509052 100644
--- a/styleguide/a-z-word-list-term-collections/o/open-source.md
+++ b/styleguide/a-z-word-list-term-collections/o/open-source.md
@@ -1,5 +1,6 @@
---
title: open source, open-source - Microsoft Style Guide
+description: Describes guidelines to use 'open source' or 'open-source' in Microsoft documents. Lowercase unless you're talking about the Open Source Initiative.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/open.md b/styleguide/a-z-word-list-term-collections/o/open.md
index 5b45aad0..59705680 100644
--- a/styleguide/a-z-word-list-term-collections/o/open.md
+++ b/styleguide/a-z-word-list-term-collections/o/open.md
@@ -1,5 +1,6 @@
---
title: open - Microsoft Style Guide
+description: Describes guidelines to use 'open' in Microsoft documents and provides a link to describing interactions with UI terms.
author: pallep
ms.author: pallep
ms.date: 04/30/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/operating-environment-operating-system.md b/styleguide/a-z-word-list-term-collections/o/operating-environment-operating-system.md
index 1ae58ea0..3c84acef 100644
--- a/styleguide/a-z-word-list-term-collections/o/operating-environment-operating-system.md
+++ b/styleguide/a-z-word-list-term-collections/o/operating-environment-operating-system.md
@@ -1,5 +1,6 @@
---
title: operating environment, operating system - Microsoft Style Guide
+description: Describes guidelines to use 'operating environment' or 'operating system' in Microsoft documents and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/opt-in-opt-out.md b/styleguide/a-z-word-list-term-collections/o/opt-in-opt-out.md
index 52fd5109..0b27d780 100644
--- a/styleguide/a-z-word-list-term-collections/o/opt-in-opt-out.md
+++ b/styleguide/a-z-word-list-term-collections/o/opt-in-opt-out.md
@@ -1,5 +1,6 @@
---
title: opt in, opt out - Microsoft Style Guide
+description: Describes guidelines to use 'opt in' or 'opt-out' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/option-button.md b/styleguide/a-z-word-list-term-collections/o/option-button.md
index cc5060e1..c5b0e0f3 100644
--- a/styleguide/a-z-word-list-term-collections/o/option-button.md
+++ b/styleguide/a-z-word-list-term-collections/o/option-button.md
@@ -1,5 +1,6 @@
---
title: option, option button - Microsoft Style Guide
+description: Describes guidelines to use 'option' or 'option button' in Microsoft documents and provides a link to describing interactions with UI terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/org-organization.md b/styleguide/a-z-word-list-term-collections/o/org-organization.md
index 398b40f1..4eef3c91 100644
--- a/styleguide/a-z-word-list-term-collections/o/org-organization.md
+++ b/styleguide/a-z-word-list-term-collections/o/org-organization.md
@@ -1,5 +1,6 @@
---
title: org, organization - Microsoft Style Guide
+description: Describes guidelines to use 'org' or 'organization' in Microsoft documents and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 09/11/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/output.md b/styleguide/a-z-word-list-term-collections/o/output.md
index 1b88d13e..ac484fa3 100644
--- a/styleguide/a-z-word-list-term-collections/o/output.md
+++ b/styleguide/a-z-word-list-term-collections/o/output.md
@@ -1,5 +1,6 @@
---
title: output - Microsoft Style Guide
+description: Describes guidelines to use 'output' in Microsoft documents and provides usage examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/outside.md b/styleguide/a-z-word-list-term-collections/o/outside.md
index 8b033aeb..3e207d1c 100644
--- a/styleguide/a-z-word-list-term-collections/o/outside.md
+++ b/styleguide/a-z-word-list-term-collections/o/outside.md
@@ -1,5 +1,6 @@
---
title: outside - Microsoft Style Guide
+description: Describes guidelines to use 'outside' in Microsoft documents and provides an example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/over.md b/styleguide/a-z-word-list-term-collections/o/over.md
index 7a483517..159c59d0 100644
--- a/styleguide/a-z-word-list-term-collections/o/over.md
+++ b/styleguide/a-z-word-list-term-collections/o/over.md
@@ -1,5 +1,6 @@
---
title: over - Microsoft Style Guide
+description: Describes guidelines to use 'over' in Microsoft documents and provides an alternative usage example.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/o/overwrite.md b/styleguide/a-z-word-list-term-collections/o/overwrite.md
index a4aafa44..d4310c2b 100644
--- a/styleguide/a-z-word-list-term-collections/o/overwrite.md
+++ b/styleguide/a-z-word-list-term-collections/o/overwrite.md
@@ -1,5 +1,6 @@
---
title: overwrite - Microsoft Style Guide
+description: Describes guidelines to use 'overwrite' in Microsoft documents. Use only to describe replacing existing data with new data.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/p-code.md b/styleguide/a-z-word-list-term-collections/p/p-code.md
index fa882c43..9857e922 100644
--- a/styleguide/a-z-word-list-term-collections/p/p-code.md
+++ b/styleguide/a-z-word-list-term-collections/p/p-code.md
@@ -1,5 +1,6 @@
---
title: p-code - Microsoft Style Guide
+description: Describes guidelines to use 'p-code' in Microsoft documents. Spell out on the first mention.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/page.md b/styleguide/a-z-word-list-term-collections/p/page.md
index 0fcc64dc..a9d2c6c1 100644
--- a/styleguide/a-z-word-list-term-collections/p/page.md
+++ b/styleguide/a-z-word-list-term-collections/p/page.md
@@ -1,5 +1,6 @@
---
title: page - Microsoft Style Guide
+description: Describes guidelines to use 'page' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/palette.md b/styleguide/a-z-word-list-term-collections/p/palette.md
index e2a1a927..7bcca5b3 100644
--- a/styleguide/a-z-word-list-term-collections/p/palette.md
+++ b/styleguide/a-z-word-list-term-collections/p/palette.md
@@ -1,5 +1,6 @@
---
title: palette - Microsoft Style Guide
+description: Describes guidelines to use 'palette' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/31/2019
diff --git a/styleguide/a-z-word-list-term-collections/p/pan.md b/styleguide/a-z-word-list-term-collections/p/pan.md
index 1a9cc2b1..86617260 100644
--- a/styleguide/a-z-word-list-term-collections/p/pan.md
+++ b/styleguide/a-z-word-list-term-collections/p/pan.md
@@ -1,5 +1,6 @@
---
title: pan - Microsoft Style Guide
+description: Provides a link to commonly used touch and pen interaction terms which includes 'pan'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pane.md b/styleguide/a-z-word-list-term-collections/p/pane.md
index ea0649c5..307a9aaf 100644
--- a/styleguide/a-z-word-list-term-collections/p/pane.md
+++ b/styleguide/a-z-word-list-term-collections/p/pane.md
@@ -1,5 +1,6 @@
---
title: pane - Microsoft Style Guide
+description: Describes guidelines to use 'pane' in Microsoft documents and provides a link to commonly used interactions with UI terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/parameter.md b/styleguide/a-z-word-list-term-collections/p/parameter.md
index b3056827..624e33e4 100644
--- a/styleguide/a-z-word-list-term-collections/p/parameter.md
+++ b/styleguide/a-z-word-list-term-collections/p/parameter.md
@@ -1,5 +1,6 @@
---
title: parameter - Microsoft Style Guide
+description: Describes guidelines to use 'parameter' in Microsoft documents and provides a link to commonly used terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/parenthesis-parentheses.md b/styleguide/a-z-word-list-term-collections/p/parenthesis-parentheses.md
index 49e934ea..2e73d692 100644
--- a/styleguide/a-z-word-list-term-collections/p/parenthesis-parentheses.md
+++ b/styleguide/a-z-word-list-term-collections/p/parenthesis-parentheses.md
@@ -1,5 +1,6 @@
---
title: parenthesis, parentheses - Microsoft Style Guide
+description: Describes guidelines to use 'parenthesis' or 'parentheses' in Microsoft documents and provides a link to formatting punctuation.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/passwordless.md b/styleguide/a-z-word-list-term-collections/p/passwordless.md
index b0da8f21..8273a185 100644
--- a/styleguide/a-z-word-list-term-collections/p/passwordless.md
+++ b/styleguide/a-z-word-list-term-collections/p/passwordless.md
@@ -1,5 +1,6 @@
---
title: passwordless - Microsoft Style Guide
+description: Describes guidelines to use 'passwordless' in Microsoft documents and provides alternate usage examples.
author: pallep
ms.author: pallep
ms.date: 05/28/2019
diff --git a/styleguide/a-z-word-list-term-collections/p/path.md b/styleguide/a-z-word-list-term-collections/p/path.md
index 30507963..d7d33157 100644
--- a/styleguide/a-z-word-list-term-collections/p/path.md
+++ b/styleguide/a-z-word-list-term-collections/p/path.md
@@ -1,5 +1,6 @@
---
title: path - Microsoft Style Guide
+description: Describes guidelines to use 'path' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pc.md b/styleguide/a-z-word-list-term-collections/p/pc.md
index 1b995fbb..a3e0b35b 100644
--- a/styleguide/a-z-word-list-term-collections/p/pc.md
+++ b/styleguide/a-z-word-list-term-collections/p/pc.md
@@ -1,5 +1,6 @@
---
title: PC - Microsoft Style Guide
+description: Provides a link to commonly used computer and device terms which includes 'PC'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/pen.md b/styleguide/a-z-word-list-term-collections/p/pen.md
index 8cb26999..dfcd0487 100644
--- a/styleguide/a-z-word-list-term-collections/p/pen.md
+++ b/styleguide/a-z-word-list-term-collections/p/pen.md
@@ -1,5 +1,6 @@
---
title: pen - Microsoft Style Guide
+description: Provides a link to commonly used computer and device terms which includes 'pen'.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/per.md b/styleguide/a-z-word-list-term-collections/p/per.md
index 4e74b4a7..07893d3a 100644
--- a/styleguide/a-z-word-list-term-collections/p/per.md
+++ b/styleguide/a-z-word-list-term-collections/p/per.md
@@ -1,5 +1,6 @@
---
title: per - Microsoft Style Guide
+description: Describes guidelines to use 'per' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/percent-percentage.md b/styleguide/a-z-word-list-term-collections/p/percent-percentage.md
index 1d947563..f9821f95 100644
--- a/styleguide/a-z-word-list-term-collections/p/percent-percentage.md
+++ b/styleguide/a-z-word-list-term-collections/p/percent-percentage.md
@@ -1,5 +1,6 @@
---
title: percent, percentage - Microsoft Style Guide
+description: Describes guidelines to use 'percent' or 'percentage' in Microsoft documents and provides examples with exceptions.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/perimeter-network.md b/styleguide/a-z-word-list-term-collections/p/perimeter-network.md
index 00f6b02d..d71f3188 100644
--- a/styleguide/a-z-word-list-term-collections/p/perimeter-network.md
+++ b/styleguide/a-z-word-list-term-collections/p/perimeter-network.md
@@ -1,5 +1,6 @@
---
title: perimeter network - Microsoft Style Guide
+description: Describes guidelines to use 'perimeter network' in Microsoft documents.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/a-z-word-list-term-collections/p/peripheral.md b/styleguide/a-z-word-list-term-collections/p/peripheral.md
index 3d32fd99..2edd7ee7 100644
--- a/styleguide/a-z-word-list-term-collections/p/peripheral.md
+++ b/styleguide/a-z-word-list-term-collections/p/peripheral.md
@@ -1,5 +1,6 @@
---
title: peripheral - Microsoft Style Guide
+description: Describes guidelines to use 'peripheral' in Microsoft documents and provides a link to commonly used computer and device terms.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
From 5ce01d90214f1806f4497f20c036042dfa49b495 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:24:07 -0500
Subject: [PATCH 247/486] Update date-time-terms.md
---
.../term-collections/date-time-terms.md | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index e0a8d983..528e38aa 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -3,7 +3,7 @@ title: Date and time terms - Microsoft Style Guide
description: Describes how to implement date and time terms and provides a table that outlines the usage for various date and time terms.
author: pallep
ms.author: pallep
-ms.date: 08/10/2021
+ms.date: 06/24/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -16,8 +16,7 @@ This section covers usage for terms related to time and date.
| Term | Usage |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM |
-| **Clock time** | Use the ratio symbol Unicode 2236 (alt+2236) as the delimiter between hours, minutes, and seconds, rather than the standard colon (Unicode 003A).
A standard colon is baseline aligned, the ratio symbol, on the other hand, is vertically centered between the baseline and cap-height. **Example**  |
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
| **midnight, noon** | Use *noon* and *midnight*. Don't use *12∶00 noon* and *12∶00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
From 526b6feeb054f04ae3a1a7373cce35053e8a6ff4 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:26:42 -0500
Subject: [PATCH 248/486] Update date-time-terms.md
---
.../term-collections/date-time-terms.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 528e38aa..41e97bc8 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -16,13 +16,13 @@ This section covers usage for terms related to time and date.
| Term | Usage |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **24/7** | Don't use. Use *all day, every day, always,* or something similar. |
-| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10∶45 AM 6∶30 PM
+| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*. **Examples** 10:45 AM 6:30 PM
| **Dates** | Use the following format for dates: *month day, year,* as in *July 31, 2016*. Don't use *day month year,* as in *31 July 2016*.
In UI, it's OK to use numbers and slashes for dates if the code supports that format and automatically displays the appropriate date format for different locales.
Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date. **Examples** February 16, 2016 2/16/16 (in UI) |
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
-| **midnight, noon** | Use *noon* and *midnight*. Don't use *12∶00 noon* and *12∶00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
+| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
| **Months: January–December** | Capitalize the names of months and their abbreviations.
Don't use abbreviations unless space is extremely limited. Use three-letter abbreviations when necessary: *Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* Don't include a period with the abbreviations. |
| **Seasons: Fall, autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
-| **Time, ranges of time** | Use numerals for times of day: 2∶00, 4∶15, 7∶30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10∶00 AM to 2∶00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10∶00 AM–2∶00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2∶15 AM–4∶45 PM 4/1/16 (time range on a single day) 12/1/17 2∶15 PM – 4/1/18 4∶45 PM (time plus date range) |
+| **Time, ranges of time** | Use numerals for times of day: 2:00, 4:15, 7:30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10:00 AM to 2:00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10:00 AM–2:00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2:15 AM–4:45 PM 4/1/16 (time range on a single day) 12/1/17 2:15 PM – 4/1/18 4:45 PM (time plus date range) |
| **Time zones: Eastern Time, Central Time, Mountain Time, Pacific Time, Coordinated Universal Time (UTC), Greenwich Mean Time (GMT)** | Capitalize time zones. Don't abbreviate unless space is severely limited. If you must abbreviate, use *ET, CT, MT,* and *PT*.
Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.
If you're referring to a time zone as a geographical area, call it a zone. **Example** in the Pacific Time zone
Not all time zones have names, and some time-zone names are used in more than one geographical area. If you're talking about a particular place, clarify the country or reference Coordinated Universal Time (UTC). Don't include spaces around the plus sign (+) or hyphen (-). **Examples** Eastern Time (UTC-5) Eastern Time (UTC+10) Eastern Time (Australia)
For time zones without names, refer to the offset from Coordinated Universal Time. **Example** UTC+7
Don't abbreviate *Coordinated Universal Time* in text unless space is severely limited. Use *UTC,* never *CUT*. (It's OK to use UTC in references to a specific time zone, such as *UTC+7*.) Don't use *Universal Time Coordinate or Universal Time Coordinated*.
Don't use *Greenwich Mean Time* or *GMT* by itself unless you have no other choice. Use *Coordinated Universal Time* instead. On the first mention, it's OK to refer to *Coordinated Universal Time (Greenwich Mean Time)*. |
## Abbreviating units of time
From 539aee38aa4e6017351fc09ef5b75723e34621f0 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:27:34 -0500
Subject: [PATCH 249/486] Update colons.md
---
styleguide/punctuation/colons.md | 7 +------
1 file changed, 1 insertion(+), 6 deletions(-)
diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md
index 34988b8e..86a84c3e 100644
--- a/styleguide/punctuation/colons.md
+++ b/styleguide/punctuation/colons.md
@@ -3,7 +3,7 @@ title: Colons - Microsoft Style Guide
description: Describes how to use colons in various contexts including preceding lists, within sentences, in titles and headings, in UI, and when displaying clock time.
author: pallep
ms.author: pallep
-ms.date: 03/03/2022
+ms.date: 06/24/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -52,8 +52,3 @@ Get started with Azure IoT: An interactive developer guide
Don’t use colon when introducing lists of radio buttons or checkboxes.
-## When displaying clock time
-
-Don't use colons when displaying clock time. Use Unicode 2236 (ratio symbol) instead. See [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms).
-**Example**
-The meeting is scheduled for 1∶00 PM.
From 12c49eed5343e8c5a324df7d7b991db42bfbfd83 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:33:07 -0500
Subject: [PATCH 250/486] Update nouns-pronouns.md
---
styleguide/grammar/nouns-pronouns.md | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index bf829452..d871aa0a 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -3,7 +3,7 @@ title: Nouns and pronouns - Microsoft Style Guide
description: Discusses proper nouns, which are one of a kind—unique people, places, and things. Capitalize proper nouns wherever they occur.
author: pallep
ms.author: pallep
-ms.date: 09/13/2019
+ms.date: 06/24/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -28,7 +28,7 @@ Proper nouns include:
- Managed standards, such as Bluetooth.
-If there's more than one of a thing, it's a common noun. For example, there are lots of chief operating officers, so *chief operating officer* is a common noun. There's only one *Latasha Sharp, Chief Operating Officer,* so that's a proper noun.
+If there's more than one of a thing, it's a common noun. For example, there are lots of chief operating officers, so *chief operating officer* is a common noun. There's only one *Chief Operating Officer Latasha Sharp,* so that's a proper noun.
Don't
capitalize common nouns unless they begin a sentence or the situation
@@ -76,7 +76,6 @@ you're writing about real people who use those pronouns themselves.
*They* can be used as a non-binary pronoun for a singular person instead of a binary pronoun (*she* or *he*).
-
For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](~/bias-free-communication.md).
## Pronouns and collective nouns
@@ -85,3 +84,7 @@ Collective nouns like *company* take a singular pronoun. Don't use a plural pron
**Examples** Meet with up to 250 people. All they need is a phone or internet connection. The company upgraded its cloud storage solution to Microsoft Azure.
**Exception** If the emphasis is on the individuals in a group, it's OK to use a plural pronoun with a singular noun.
+
+## Using pronouns in product UI
+
+See also [Person] (https://docs.microsoft.com/en-us/style-guide/grammar/person)
From 3392d1ac70708b088537f773eeed49481c49289f Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:34:12 -0500
Subject: [PATCH 251/486] Update nouns-pronouns.md
---
styleguide/grammar/nouns-pronouns.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index d871aa0a..0bb569e0 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -47,7 +47,7 @@ Capitalize technology terms as proper nouns only when:
If you're not sure whether a term is a proper noun (and thus capitalized) or a common noun (lowercase), check *[The American Heritage Dictionary](https://ahdictionary.com/)* and the A–Z word list. Default to lowercase unless there's a compelling reason to capitalize the term.
-**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](~/capitalization.md).
+**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](https://docs.microsoft.com/en-us/style-guide/grammar/person)).
## Plural nouns
From 533fcd236719b4ff0e15be052e03eb01fc1af3a9 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:34:56 -0500
Subject: [PATCH 252/486] Update nouns-pronouns.md
---
styleguide/grammar/nouns-pronouns.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index 0bb569e0..3d099044 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -47,7 +47,7 @@ Capitalize technology terms as proper nouns only when:
If you're not sure whether a term is a proper noun (and thus capitalized) or a common noun (lowercase), check *[The American Heritage Dictionary](https://ahdictionary.com/)* and the A–Z word list. Default to lowercase unless there's a compelling reason to capitalize the term.
-**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](https://docs.microsoft.com/en-us/style-guide/grammar/person)).
+**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](https://docs.microsoft.com/en-us/style-guide/grammar/person).
## Plural nouns
@@ -76,7 +76,7 @@ you're writing about real people who use those pronouns themselves.
*They* can be used as a non-binary pronoun for a singular person instead of a binary pronoun (*she* or *he*).
-For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](~/bias-free-communication.md).
+For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication).
## Pronouns and collective nouns
From 26bfba4096732f5ad649dc8e5e3e89d3d3bb88c8 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:35:32 -0500
Subject: [PATCH 253/486] Update nouns-pronouns.md
---
styleguide/grammar/nouns-pronouns.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index 3d099044..02e853c7 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -87,4 +87,4 @@ Collective nouns like *company* take a singular pronoun. Don't use a plural pron
## Using pronouns in product UI
-See also [Person] (https://docs.microsoft.com/en-us/style-guide/grammar/person)
+See also [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person).
From 7d43009fe567df73a50dfc31ff6d747f557223cf Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:41:00 -0500
Subject: [PATCH 254/486] Update person.md
---
styleguide/grammar/person.md | 53 +++++++++++++++++++++++++-----------
1 file changed, 37 insertions(+), 16 deletions(-)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index 3a2ca946..17ff79ba 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -3,7 +3,7 @@ title: Person - Microsoft Style Guide
description: Discusses that in grammar, person refers to the point of view represented by a statement and determines which pronoun to use.
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 06/24/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -12,29 +12,50 @@ ms.prod: non-product-specific
In grammar, *person* refers to the point of view represented by a statement and determines which pronoun to use.
-## In general, use second person
+## In general, use second person pronouns (you, your)
-In second person, you write as though you're speaking to the reader. Second person often uses the personal pronoun *you,* but sometimes the word *you* is implied. It
+In second person, you write as though you're speaking to the reader. The second person often uses the personal pronoun *you* or *your*, but sometimes the word *you* is implied. It
supports a friendly, human tone and helps avoid passive voice
-by focusing the discussion on the reader. Consider omitting *you can* whenever the sentence works without it.
+by focusing the discussion on the reader. Omit *you can* whenever the sentence works without it.
+
+In product UI, avoid using you and your in ways that sound like we're commanding people to do something rather than providing options for them to make their own choices.
+
+However, when AI-generated content is used, we should use past tense (to express action done behind the scenes) by explicitly saying “for you” or by using words that convey uncertainty or subjectivity (to express that a judgment was applied that may or may not be correct).
+**Examples**
+
+Check if you have local admin rights.
+
+Depending on your choice, some features may be turned off by default.
+
+Change your settings
+
+Suggested for you
+
+## Use singular first person pronouns sparingly (I, me, my)
+
+In first person, you write as though you’re speaking from the reader’s point of view. Marketing and support documentation should never use first person singular. However, it may be used inside our product experiences. First-person singular pronouns can be used in product UI to show someone’s control over an action in checkbox, button, or toggle labels.
**Examples**
-Create your own unique Lumia experience.
-You can set advanced options later if you need them.
+Notify me when a new Bluetooth device tries to connect to my computer
-## Use first person sparingly
+Remember my password
-Use first person (usually *I* or *me*) only when you need to write from the point of view of the customer.
-**Example**
-Alert me when a new Bluetooth device tries to connect to my computer. (checkbox text)
+I agree to the terms of service
+
+**Exception** In rare cases, it’s OK to use “my” in navigation or filter labels if you need to distinguish a person’s content from other content that may be presented in the same visual space.
**Exception** Cortana is a persona, so the use of *I* is appropriate.
-## Avoid first-person plural
+## Avoid plural first person (we, us)
-First-person plural, which often uses the pronoun *we,* can feel like a daunting corporate presence—the opposite of Microsoft's modern voice. It's OK to use phrasing like *we recommend* if it helps you avoid awkward phrasing like *it's recommended,* but write around it if you can. Try to keep the focus on the customer, not Microsoft.
+First-person plural, which often uses the pronoun *we,* can feel like a daunting corporate presence—the opposite of Microsoft's modern voice. It's OK to use phrasing like *we recommend* if it helps you avoid awkward phrasing like *it's recommended,* but write around it if you can. Try to keep the focus on the customer, not Microsoft. It’s OK to use we in privacy and security settings where you need to make clear Microsoft is the speaker.
**Examples**
-Select the people you want to give permission to. We'll verify their identities before opening the document.
-In September, we took a major step forward in introducing Windows 10 to our enterprise customers.
-The scheduled default setting is the easiest way to keep your computer up to date. (Instead of *We recommend that you use the scheduled default setting ....*)
+Notify scheduled default setting is the easiest way to keep your computer up to date. (Instead of *We recommend that you use the scheduled default setting ....*)
+
+Change your password (Instead of *We recommend that you change your password.*)
+
+We protect your privacy at every step.
+
+That didn’t work. Try again. (Instead of *We weren’t able to run the Solution Checker. Try running it again.*)
+
+Allow Microsoft to contact you about this feedback
-**See also** [Microsoft](~/a-z-word-list-term-collections/m/microsoft.md)
From 625fc6c0d9e12711ceab526c1bf94854c012ef9f Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:41:41 -0500
Subject: [PATCH 255/486] Update person.md
---
styleguide/grammar/person.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index 17ff79ba..c9d29cd7 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -12,7 +12,7 @@ ms.prod: non-product-specific
In grammar, *person* refers to the point of view represented by a statement and determines which pronoun to use.
-## In general, use second person pronouns (you, your)
+## In general, use second-person pronouns (you, your)
In second person, you write as though you're speaking to the reader. The second person often uses the personal pronoun *you* or *your*, but sometimes the word *you* is implied. It
supports a friendly, human tone and helps avoid passive voice
@@ -31,7 +31,7 @@ Change your settings
Suggested for you
-## Use singular first person pronouns sparingly (I, me, my)
+## Use singular first-person pronouns sparingly (I, me, my)
In first person, you write as though you’re speaking from the reader’s point of view. Marketing and support documentation should never use first person singular. However, it may be used inside our product experiences. First-person singular pronouns can be used in product UI to show someone’s control over an action in checkbox, button, or toggle labels.
**Examples**
From d26b73c17cd8bbaa0fcef3815c5f9f9a1646eb8a Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:43:00 -0500
Subject: [PATCH 256/486] Update person.md
---
styleguide/grammar/person.md | 20 +++++++-------------
1 file changed, 7 insertions(+), 13 deletions(-)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index c9d29cd7..aa87b1f1 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -21,24 +21,21 @@ by focusing the discussion on the reader. Omit *you can* whenever the sentence w
In product UI, avoid using you and your in ways that sound like we're commanding people to do something rather than providing options for them to make their own choices.
However, when AI-generated content is used, we should use past tense (to express action done behind the scenes) by explicitly saying “for you” or by using words that convey uncertainty or subjectivity (to express that a judgment was applied that may or may not be correct).
-**Examples**
+**Examples**
Check if you have local admin rights.
-
Depending on your choice, some features may be turned off by default.
-
Change your settings
-
Suggested for you
## Use singular first-person pronouns sparingly (I, me, my)
-In first person, you write as though you’re speaking from the reader’s point of view. Marketing and support documentation should never use first person singular. However, it may be used inside our product experiences. First-person singular pronouns can be used in product UI to show someone’s control over an action in checkbox, button, or toggle labels.
+In first person, you write as though you’re speaking from the reader’s point of view. Marketing and support documentation should never use first person singular. However, it may be used inside our product experiences.
+First-person singular pronouns can be used in product UI to show someone’s control over an action in checkbox, button, or toggle labels.
+
**Examples**
Notify me when a new Bluetooth device tries to connect to my computer
-
Remember my password
-
I agree to the terms of service
**Exception** In rare cases, it’s OK to use “my” in navigation or filter labels if you need to distinguish a person’s content from other content that may be presented in the same visual space.
@@ -47,15 +44,12 @@ I agree to the terms of service
## Avoid plural first person (we, us)
-First-person plural, which often uses the pronoun *we,* can feel like a daunting corporate presence—the opposite of Microsoft's modern voice. It's OK to use phrasing like *we recommend* if it helps you avoid awkward phrasing like *it's recommended,* but write around it if you can. Try to keep the focus on the customer, not Microsoft. It’s OK to use we in privacy and security settings where you need to make clear Microsoft is the speaker.
+First-person plural, which often uses the pronoun *we,* can feel like a daunting corporate presence—the opposite of Microsoft's modern voice. It's OK to use phrasing like *we recommend* if it helps you avoid awkward phrasing like *it's recommended,* but write around it if you can. Try to keep the focus on the customer, not Microsoft.
+It’s OK to use we in privacy and security settings where you need to make clear Microsoft is the speaker.
+
**Examples**
Notify scheduled default setting is the easiest way to keep your computer up to date. (Instead of *We recommend that you use the scheduled default setting ....*)
-
Change your password (Instead of *We recommend that you change your password.*)
-
We protect your privacy at every step.
-
That didn’t work. Try again. (Instead of *We weren’t able to run the Solution Checker. Try running it again.*)
-
Allow Microsoft to contact you about this feedback
-
From a46766d2536c7b5cc70d70af48343c9b079c4290 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:43:38 -0500
Subject: [PATCH 257/486] Update person.md
---
styleguide/grammar/person.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index aa87b1f1..b1a0eda9 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -39,6 +39,7 @@ Remember my password
I agree to the terms of service
**Exception** In rare cases, it’s OK to use “my” in navigation or filter labels if you need to distinguish a person’s content from other content that may be presented in the same visual space.
+
**Exception** Cortana is a persona, so the use of *I* is appropriate.
From 7ec02853a0ddd652ac6c016dba036b497480f5f3 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:44:28 -0500
Subject: [PATCH 258/486] Update person.md
---
styleguide/grammar/person.md | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)
diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md
index b1a0eda9..4d1535eb 100644
--- a/styleguide/grammar/person.md
+++ b/styleguide/grammar/person.md
@@ -24,10 +24,14 @@ However, when AI-generated content is used, we should use past tense (to express
**Examples**
Check if you have local admin rights.
+
Depending on your choice, some features may be turned off by default.
+
Change your settings
+
Suggested for you
+
## Use singular first-person pronouns sparingly (I, me, my)
In first person, you write as though you’re speaking from the reader’s point of view. Marketing and support documentation should never use first person singular. However, it may be used inside our product experiences.
@@ -35,7 +39,9 @@ First-person singular pronouns can be used in product UI to show someone’s con
**Examples**
Notify me when a new Bluetooth device tries to connect to my computer
+
Remember my password
+
I agree to the terms of service
**Exception** In rare cases, it’s OK to use “my” in navigation or filter labels if you need to distinguish a person’s content from other content that may be presented in the same visual space.
@@ -50,7 +56,11 @@ It’s OK to use we in privacy and security settings where you need to make clea
**Examples**
Notify scheduled default setting is the easiest way to keep your computer up to date. (Instead of *We recommend that you use the scheduled default setting ....*)
-Change your password (Instead of *We recommend that you change your password.*)
+
+Change your password (Instead of *We recommend that you change your password.*)
+
We protect your privacy at every step.
+
That didn’t work. Try again. (Instead of *We weren’t able to run the Solution Checker. Try running it again.*)
+
Allow Microsoft to contact you about this feedback
From 22eb9d7a2c04daa9759252c1671d7d0b5eaf79fa Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:51:44 -0500
Subject: [PATCH 259/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index d700278c..9f0f77a2 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -15,6 +15,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| June 24, 2022 | [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Colons]([/style-guide/punctuation/periods](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns]([/style-guide/numbers](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person]([/style-guide/a-z-word-list-term-collections/p/phone](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
From 49a7d096bc1daba18a1c29fe7d3d6b1ebc6e7827 Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:52:39 -0500
Subject: [PATCH 260/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 9f0f77a2..5804aa4a 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 05/13/2022
+ms.date: 06/24/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -16,9 +16,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| June 24, 2022 | [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Colons]([/style-guide/punctuation/periods](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Nouns and pronouns]([/style-guide/numbers](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
-| June 24, 2022 | [Person]([/style-guide/a-z-word-list-term-collections/p/phone](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
+| June 24, 2022 | [Colons](/style-guide/punctuation/periods](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns](/style-guide/numbers](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person](/style-guide/a-z-word-list-term-collections/p/phone](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
From ad46490f4cbc0eecfa7f9d67a72d5a5babb1987a Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Fri, 24 Jun 2022 14:53:24 -0500
Subject: [PATCH 261/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 5804aa4a..f069c5d2 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,9 +16,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| June 24, 2022 | [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Colons](/style-guide/punctuation/periods](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Nouns and pronouns](/style-guide/numbers](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
-| June 24, 2022 | [Person](/style-guide/a-z-word-list-term-collections/p/phone](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
+| June 24, 2022 | [Colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
From cf4a389948e3ff7e6f10d1b05ba1e341310b4b15 Mon Sep 17 00:00:00 2001
From: Dhurata Jahiu <101433552+DhurataJ@users.noreply.github.com>
Date: Tue, 9 Aug 2022 11:19:59 -0400
Subject: [PATCH 262/486] [BrokenLinksH2] Fix path in link
removed broken link
---
styleguide/word-choice/use-technical-terms-carefully.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/word-choice/use-technical-terms-carefully.md b/styleguide/word-choice/use-technical-terms-carefully.md
index 243fc1ad..2344b3be 100644
--- a/styleguide/word-choice/use-technical-terms-carefully.md
+++ b/styleguide/word-choice/use-technical-terms-carefully.md
@@ -38,7 +38,7 @@ you're writing for an industry or profession, use the words your
audience uses. First, verify Microsoft and industry usage. Check
the A–Z word list and [*The American Heritage Dictionary*](https://ahdictionary.com/). Then look to authoritative industry resources:
- - Terminology websites, such as [Webopedia.com](https://www.webopedia.com/), [BusinessDictionary.com](https://www.businessdictionary.com/), and [Whatis.TechTarget.com](https://whatis.techtarget.com/).
+ - Terminology websites, such as [Webopedia.com](https://www.webopedia.com/), and [Whatis.TechTarget.com](https://whatis.techtarget.com/).
- Industry standard sites, such as [W3C](https://www.w3.org/standards/xml) and [IEEE](https://www.ieee.org/index.html).
From b0884563d3b3242031858cbe2debfc1919f5b439 Mon Sep 17 00:00:00 2001
From: Dhurata Jahiu <101433552+DhurataJ@users.noreply.github.com>
Date: Tue, 9 Aug 2022 11:25:10 -0400
Subject: [PATCH 263/486] [BrokenLinksH2] Fix path in link
Link should be unclickable
---
.../writing-step-by-step-instructions.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/procedures-instructions/writing-step-by-step-instructions.md b/styleguide/procedures-instructions/writing-step-by-step-instructions.md
index d1227914..8fbd1552 100644
--- a/styleguide/procedures-instructions/writing-step-by-step-instructions.md
+++ b/styleguide/procedures-instructions/writing-step-by-step-instructions.md
@@ -64,7 +64,7 @@ numbered list. For multiple-step procedures in numbered lists:
**To schedule sprints**
1. In the **Backlogs** view, select the first sprint under **Current**. Or, open your sprint backlog from the following URL:
- [https://AccountName/DefaultCollection/TeamProjectName/\_backlogs/iteration](https://accountname/DefaultCollection/TeamProjectName/_backlogs/iteration)
+ `https://AccountName/DefaultCollection/TeamProjectName/\_backlogs/iteration`
Several predefined sprints are listed under **Current** and **Future**. Actual sprint titles vary based on the [process template](https://msdn.microsoft.com/library/ms400752.aspx) used to create your team project. However, calendar dates haven’t been assigned.
2. To set the calendar dates, select the first sprint under **Current**, and select dates.
From 1186feaeeeeffd06c57ff6a97681e0f45a385858 Mon Sep 17 00:00:00 2001
From: Dhurata Jahiu <101433552+DhurataJ@users.noreply.github.com>
Date: Tue, 9 Aug 2022 11:28:30 -0400
Subject: [PATCH 264/486] [BrokenLinksH2] Fix path in link
Fixing broken link
---
styleguide/content-planning.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/content-planning.md b/styleguide/content-planning.md
index 7ef77724..63c7c545 100644
--- a/styleguide/content-planning.md
+++ b/styleguide/content-planning.md
@@ -94,7 +94,7 @@ With these questions answered, you can narrow your approach. For example:
| **Get timely communications, including news, announcements, event updates, tips, and stories** | Blog Newsletter | [OneNote, The Microsoft Office Blog](https://blogs.office.com/b/microsoft-onenote) [Virtual PC Guy’s blog](https://blogs.msdn.microsoft.com/virtual_pc_guy/) [MSDN Flash newsletter](https://msdn.microsoft.com/dn957574#full) |
| **Get answers and expertise from a community** | Wiki Forum | [TechNet wiki](https://social.technet.microsoft.com/wiki/) [Exchange Server Forum](https://social.technet.microsoft.com/Forums/category/exchangeserver) [Microsoft Answers](https://answers.microsoft.com/en-us) |
| **Learn a complex or comprehensive concept or skill** | Online training Tutorial Technical white paper Interactive graphics System architecture | [Make and receive calls using Skype for Business](https://support.office.com//article/Make-and-receive-calls-using-Skype-for-Business-228e03aa-7361-4997-8dfa-1dd9bdc717f6) [SharePoint Automation with DSC](https://mva.microsoft.com/training-courses/sharepoint-automation-with-dsc-17843) [Azure Network Security (PDF)](https://download.microsoft.com/download/C/A/3/CA3FC5C0-ECE0-4F87-BF4B-D74064A00846/AzureNetworkSecurity_v3_Feb2015.pdf) [Technical diagrams for SharePoint 2013](https://technet.microsoft.com/library/cc263199.aspx) |
-| **Learn or increase knowledge and skills related to a product, service, technology, or business concept** | Concept papers E-books Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) [SharePoint with SQL Server AlwaysOn](https://azure.microsoft.com/documentation/infographics/sharepoint-sqlserver-alwayson/) [Microsoft Dynamics NAV: Grow Your Business e-book](https://www.microsoft.com/en-gb/download/details.aspx?id=44936) |
+| **Learn or increase knowledge and skills related to a product, service, technology, or business concept** | Concept papers E-books Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) [SharePoint with SQL Server AlwaysOn](/SharePoint/administration/deploying-sharepoint-server-with-sql-server-alwayson-availability-groups-in) [Microsoft Dynamics NAV: Grow Your Business e-book](https://www.microsoft.com/en-gb/download/details.aspx?id=44936) |
| **Learn product tips and tricks** | UI text Web documentation Apps Microblogs (such as Twitter) Blogs E-books Newsletters Communities | [Useful Tips and Tricks to Bring with You to the Vermintide 2 Beta on Xbox One](https://news.xbox.com/2018/06/20/tips-vermintide-2-beta-xbox-one/) [Skype: Keeping you connected on your vacation](https://blogs.windows.com/devices/2015/07/17/skype-keeping-you-connected-on-your-vacation/) [Windows 10 Tip: Go back and forth in time with Timeline](https://blogs.windows.com/windowsexperience/2018/06/11/windows-10-tip-go-back-and-forth-in-time-with-timeline-new-in-the-windows-10-april-2018-update/#G1eq7fS4RyKp26x0.97) |
| **Understand a process** | Interactive graphics Interactive flow charts Sample workflows Sample files | [What is governance in SharePoint 2013?](https://technet.microsoft.com/library/cc263356.aspx) [Overview of the upgrade process for SharePoint 2013](https://technet.microsoft.com/library/cc262483.aspx) [Upgrade worksheet for SharePoint 2013](https://www.microsoft.com/download/confirmation.aspx?id=30370) |
| **Troubleshoot a problem** | Interactive flow chart UI troubleshooter | [How to run the Audio Troubleshooter in Windows 10](https://www.youtube.com/watch?v=PGSR7qvbBjE&index=4&list=PLWs4_NfqMtozP_oATmM8FTMhsAPtn3m_F) |
From 46dc02e8c7047a957d88bbae232c0f4b507e754e Mon Sep 17 00:00:00 2001
From: SLRaillard <88392507+SLRaillard@users.noreply.github.com>
Date: Thu, 25 Aug 2022 10:18:23 -0500
Subject: [PATCH 265/486] Update acronyms.md
---
styleguide/acronyms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/acronyms.md b/styleguide/acronyms.md
index 9682498c..0de84671 100644
--- a/styleguide/acronyms.md
+++ b/styleguide/acronyms.md
@@ -72,7 +72,7 @@ Which article (*a* or *an*) you use depends on whether you pronounce the acronym
a DLL
an ISP
a URL
-an SQL database
+a SQL database
**Add *s* to make an acronym plural**
From 4db20cd77233d4b53a12f103fb27c2b3a87d9552 Mon Sep 17 00:00:00 2001
From: Tami Fosmark
Date: Fri, 26 Aug 2022 14:06:26 -0700
Subject: [PATCH 266/486] fix download link
---
styleguide/content-planning.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/content-planning.md b/styleguide/content-planning.md
index 63c7c545..eec4601a 100644
--- a/styleguide/content-planning.md
+++ b/styleguide/content-planning.md
@@ -90,11 +90,11 @@ With these questions answered, you can narrow your approach. For example:
| **Need** | **Content types** | **Examples** |
|---|---|---|
| **Complete a simple task or use a simple feature in an app** | UI text Documentation Short video Blog, if it's a common issue or cool, little-known feature | [Setting up email](https://windows.microsoft.com/windows-8/setup-email-contacts-tutorial) [Recall and replace sent messages](https://support.office.com/article/Recall-and-replace-sent-messages-ec29964f-ae72-4e32-bbab-945fe3dc3390) [5 easy and powerful Excel features you may not know about](https://blogs.office.com/2015/04/08/5-easy-and-powerful-excel-features-you-may-not-know-about/) |
-| **Complete a complex task or use a complex feature in an app** | UI text Video Webcast Documentation Tutorial End-to-end scenarios or conceptual articles Technical papers or articles Wizard | [Try the latest touchpad gestures](https://windows.microsoft.com/windows-10/getstarted-try-touchpad-gestures) [OneNote for (holiday) planning](https://blogs.office.com/2013/11/08/webinar-onenote-for-holiday-planning/) [Create an ASP.NET web app in Azure App Service](https://azure.microsoft.com/documentation/articles/web-sites-dotnet-get-started/) [Set up Office 365 for business](https://support.office.com/article/Set-up-Office-365-for-business-6a3a29a0-e616-4713-99d1-15eda62d04fa?ui=en-US&rs=en-US&ad=US) [Getting started with Microsoft Intune](https://www.bing.com/videos/search?q=getting+started+with+microsoft+intune&FORM=VIRE2#view=detail&mid=6C684C0693A2CB812D786C684C0693A2CB812D78) [Set up Microsoft account on your devices](https://account.microsoft.com/account/connect-devices?lang=en-us) |
+| **Complete a complex task or use a complex feature in an app** | UI text Video Webcast Documentation Tutorial End-to-end scenarios or conceptual articles Technical papers or articles Wizard | [Try the latest touchpad gestures](https://windows.microsoft.com/windows-10/getstarted-try-touchpad-gestures) [OneNote for (holiday) planning](https://blogs.office.com/2013/11/08/webinar-onenote-for-holiday-planning/) [Create an ASP.NET web app in Azure App Service](https://azure.microsoft.com/documentation/articles/web-sites-dotnet-get-started/) [Set up Office 365 for business](https://support.office.com/article/Set-up-Office-365-for-business-6a3a29a0-e616-4713-99d1-15eda62d04fa) [Getting started with Microsoft Intune](https://www.bing.com/videos/search?q=getting+started+with+microsoft+intune&FORM=VIRE2#view=detail&mid=6C684C0693A2CB812D786C684C0693A2CB812D78) [Set up Microsoft account on your devices](https://account.microsoft.com/account/connect-devices?lang=en-us) |
| **Get timely communications, including news, announcements, event updates, tips, and stories** | Blog Newsletter | [OneNote, The Microsoft Office Blog](https://blogs.office.com/b/microsoft-onenote) [Virtual PC Guy’s blog](https://blogs.msdn.microsoft.com/virtual_pc_guy/) [MSDN Flash newsletter](https://msdn.microsoft.com/dn957574#full) |
-| **Get answers and expertise from a community** | Wiki Forum | [TechNet wiki](https://social.technet.microsoft.com/wiki/) [Exchange Server Forum](https://social.technet.microsoft.com/Forums/category/exchangeserver) [Microsoft Answers](https://answers.microsoft.com/en-us) |
+| **Get answers and expertise from a community** | Wiki Forum | [TechNet wiki](https://social.technet.microsoft.com/wiki/) [Exchange Server Forum](https://social.technet.microsoft.com/Forums/category/exchangeserver) [Microsoft Answers](https://answers.microsoft.com/) |
| **Learn a complex or comprehensive concept or skill** | Online training Tutorial Technical white paper Interactive graphics System architecture | [Make and receive calls using Skype for Business](https://support.office.com//article/Make-and-receive-calls-using-Skype-for-Business-228e03aa-7361-4997-8dfa-1dd9bdc717f6) [SharePoint Automation with DSC](https://mva.microsoft.com/training-courses/sharepoint-automation-with-dsc-17843) [Azure Network Security (PDF)](https://download.microsoft.com/download/C/A/3/CA3FC5C0-ECE0-4F87-BF4B-D74064A00846/AzureNetworkSecurity_v3_Feb2015.pdf) [Technical diagrams for SharePoint 2013](https://technet.microsoft.com/library/cc263199.aspx) |
-| **Learn or increase knowledge and skills related to a product, service, technology, or business concept** | Concept papers E-books Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) [SharePoint with SQL Server AlwaysOn](/SharePoint/administration/deploying-sharepoint-server-with-sql-server-alwayson-availability-groups-in) [Microsoft Dynamics NAV: Grow Your Business e-book](https://www.microsoft.com/en-gb/download/details.aspx?id=44936) |
+| **Learn or increase knowledge and skills related to a product, service, technology, or business concept** | Concept papers E-books Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) [SharePoint with SQL Server AlwaysOn](/SharePoint/administration/deploying-sharepoint-server-with-sql-server-alwayson-availability-groups-in) [Microsoft Dynamics NAV: Grow Your Business e-book](https://www.microsoft.com/download/details.aspx?id=44237) |
| **Learn product tips and tricks** | UI text Web documentation Apps Microblogs (such as Twitter) Blogs E-books Newsletters Communities | [Useful Tips and Tricks to Bring with You to the Vermintide 2 Beta on Xbox One](https://news.xbox.com/2018/06/20/tips-vermintide-2-beta-xbox-one/) [Skype: Keeping you connected on your vacation](https://blogs.windows.com/devices/2015/07/17/skype-keeping-you-connected-on-your-vacation/) [Windows 10 Tip: Go back and forth in time with Timeline](https://blogs.windows.com/windowsexperience/2018/06/11/windows-10-tip-go-back-and-forth-in-time-with-timeline-new-in-the-windows-10-april-2018-update/#G1eq7fS4RyKp26x0.97) |
| **Understand a process** | Interactive graphics Interactive flow charts Sample workflows Sample files | [What is governance in SharePoint 2013?](https://technet.microsoft.com/library/cc263356.aspx) [Overview of the upgrade process for SharePoint 2013](https://technet.microsoft.com/library/cc262483.aspx) [Upgrade worksheet for SharePoint 2013](https://www.microsoft.com/download/confirmation.aspx?id=30370) |
| **Troubleshoot a problem** | Interactive flow chart UI troubleshooter | [How to run the Audio Troubleshooter in Windows 10](https://www.youtube.com/watch?v=PGSR7qvbBjE&index=4&list=PLWs4_NfqMtozP_oATmM8FTMhsAPtn3m_F) |
From efa6fb8a294af3ff2cb6e630150d8cd731129d7a Mon Sep 17 00:00:00 2001
From: Alex Buck
Date: Mon, 12 Sep 2022 15:58:44 -0400
Subject: [PATCH 267/486] [BULK] DocuTune - Rebranding
---
styleguide/a-z-word-list-term-collections/d/devops.md | 2 +-
.../developer-content/reference-documentation.md | 2 +-
styleguide/grammar/nouns-pronouns.md | 6 +++---
styleguide/welcome/whats-new.md | 10 +++++-----
4 files changed, 10 insertions(+), 10 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/devops.md b/styleguide/a-z-word-list-term-collections/d/devops.md
index d8273a62..f45a964e 100644
--- a/styleguide/a-z-word-list-term-collections/d/devops.md
+++ b/styleguide/a-z-word-list-term-collections/d/devops.md
@@ -1,6 +1,6 @@
---
title: DevOps - Microsoft Style Guide
-description: Describes guidelines to use 'DevOps' in Microsoft Docs. Carefully note spelling and capitalization.
+description: Describes guidelines to use 'DevOps' in Microsoft documents. Carefully note spelling and capitalization.
author: pallep
ms.author: pallep
ms.date: 01/19/2018
diff --git a/styleguide/developer-content/reference-documentation.md b/styleguide/developer-content/reference-documentation.md
index df9b8bef..8f2af6f5 100644
--- a/styleguide/developer-content/reference-documentation.md
+++ b/styleguide/developer-content/reference-documentation.md
@@ -72,4 +72,4 @@ If you automatically generate reference documentation and comments from the sour
quality and appropriateness of the comments. Developers might leave out details that are important to
customers. Remove any implementation or internal details that aren't suitable for documentation.
-**Learn more** For other examples of technical reference articles, see the [.NET API Browser](/dotnet/api/?view=netframework-4.7.1&preserve-view=true) section of [Microsoft Docs](/documentation).
+**Learn more** For other examples of technical reference articles, see the [.NET API Browser](/dotnet/api/?view=netframework-4.7.1&preserve-view=true).
diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md
index 02e853c7..295a41ce 100644
--- a/styleguide/grammar/nouns-pronouns.md
+++ b/styleguide/grammar/nouns-pronouns.md
@@ -47,7 +47,7 @@ Capitalize technology terms as proper nouns only when:
If you're not sure whether a term is a proper noun (and thus capitalized) or a common noun (lowercase), check *[The American Heritage Dictionary](https://ahdictionary.com/)* and the A–Z word list. Default to lowercase unless there's a compelling reason to capitalize the term.
-**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](https://docs.microsoft.com/en-us/style-guide/grammar/person).
+**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](/style-guide/grammar/person).
## Plural nouns
@@ -76,7 +76,7 @@ you're writing about real people who use those pronouns themselves.
*They* can be used as a non-binary pronoun for a singular person instead of a binary pronoun (*she* or *he*).
-For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication).
+For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](/style-guide/bias-free-communication).
## Pronouns and collective nouns
@@ -87,4 +87,4 @@ Collective nouns like *company* take a singular pronoun. Don't use a plural pron
## Using pronouns in product UI
-See also [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person).
+See also [Person](/style-guide/grammar/person).
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index f069c5d2..2539ecad 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -15,10 +15,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| June 24, 2022 | [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Nouns and pronouns](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
-| June 24, 2022 | [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
+| June 24, 2022 | [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Colons](/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns](/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person](/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
@@ -75,7 +75,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| March 31, 2020 | [Nouns and pronouns](~/grammar/nouns-pronouns.md) | Added guidance for *they*. |
| March 31, 2020 | [Numbers](~/numbers.md) | Updated guidance on comma usage. |
| March 31, 2020 | [runs vs. runs on](~/a-z-word-list-term-collections/r/runs-vs-runs-on.md) | Updated list of examples. |
-| March 31, 2020 | [Units of measure terms ](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) | Updated examples on Speed frequency. Also updated comma exceptions and examples. |
+| March 31, 2020 | [Units of measure terms](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) | Updated examples on Speed frequency. Also updated comma exceptions and examples. |
| September 21, 2019 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Added guidance for *scroll.* |
| September 21, 2019 | [Start button, Start menu](~/a-z-word-list-term-collections/s/start-button-start-menu.md) | Updated the guideline for when to use bold formatting for *Start.* |
| September 21, 2019 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) | Deleted *press and hold.* Clarified that *select and hold* is the correct term to use to describe pressing and holding a UI element. Added examples. |
From a5ff6d26dbaea26fa977d740ca2c82659af2a0e7 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:21:11 -0500
Subject: [PATCH 268/486] Update formatting-text-in-instructions.md
---
.../procedures-instructions/formatting-text-in-instructions.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md
index e92bc5e1..7364f0b0 100644
--- a/styleguide/procedures-instructions/formatting-text-in-instructions.md
+++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md
@@ -35,7 +35,7 @@ Use these conventions in instructions that appear in documentation and technical
| **Commands** | Use bold formatting for command names. Use sentence-style capitalization unless you need to match the UI. If a command label ends with a colon or an ellipsis, don't include that end punctuation in instructions. Don't include the word *command* unless it adds needed clarity. | Go to **Tools**, and select **Change language**. On the **Design** menu, select **Colors**, and then select a color scheme. |
| **Database names** | Bold. The capitalization of database names varies. | **WingtipToys** database |
| **Device and port names** | All uppercase. | USB |
-| **Dialog boxes** | Avoid talking about dialog boxes. Instead, describe what the customer needs to do. When you must refer to a dialog box by name, use bold formatting for the name of the dialog box. Use sentence-style capitalization unless you need to match the UI. If a dialog box label ends with a colon or an ellipsis, don't include that end punctuation in instructions. Don't include the words *dialog box* unless they add needed clarity. | Select **Upload**, and then select a file to upload. In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**. In the **Protect document** dialog box, clear the **Shapes** checkbox. |
+| **Dialog boxes** | In general, avoid talking about UI. Instead, talk about what the customer needs to do. When you need to refer to the UI element, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*. When you must refer to a dialog by name, use bold formatting for its name. Use sentence-style capitalization unless you need to match the UI. If a dialog label ends with a colon or an ellipsis, don't include that end punctuation in instructions. | Select **Upload**, and then select a file to upload. In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**. In the **Protect document** dialog box, clear the **Shapes** checkbox. |
| **Error messages** | Sentence-style capitalization. Enclose error messages in quotation marks when referring to them in text. | We can't find a scanner. Hmm ... looks like that's a broken link. If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device. |
| **File attributes** | All lowercase. | To remove the hidden attribute from all files in a folder .... |
| **File name extensions** | All lowercase. | .mdb .doc |
From 3e1fcb98af6fb85ce8668002f555c9e512c1dc9f Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:30:46 -0500
Subject: [PATCH 269/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 2539ecad..ef5c03a7 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -15,6 +15,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
| June 24, 2022 | [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
| June 24, 2022 | [Colons](/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
| June 24, 2022 | [Nouns and pronouns](/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
From 83bb5b78dc31c2565f191babfef9b72650ff5516 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:31:22 -0500
Subject: [PATCH 270/486] Update formatting-text-in-instructions.md
---
.../procedures-instructions/formatting-text-in-instructions.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md
index 7364f0b0..9365e7bf 100644
--- a/styleguide/procedures-instructions/formatting-text-in-instructions.md
+++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md
@@ -3,7 +3,7 @@ title: Formatting text in instructions - Microsoft Style Guide
description: Discusses that consistent text formatting helps readers locate and interpret information, such as instructions.
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 10/18/2022
ms.topic: article
ms.prod: non-product-specific
---
From 09d44f57562e407021da17e9a9abc2106f7f86f6 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:31:43 -0500
Subject: [PATCH 271/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index ef5c03a7..35bd8044 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 06/24/2022
+ms.date: 10/18/2022
ms.topic: article
ms.prod: non-product-specific
---
From d36a2494e8dc7c7645de2268772afacc44b6272c Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:39:50 -0500
Subject: [PATCH 272/486] Update brand-voice-above-all-simple-human.md
---
styleguide/brand-voice-above-all-simple-human.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/brand-voice-above-all-simple-human.md b/styleguide/brand-voice-above-all-simple-human.md
index fd627ac1..fdd9599d 100644
--- a/styleguide/brand-voice-above-all-simple-human.md
+++ b/styleguide/brand-voice-above-all-simple-human.md
@@ -1,5 +1,5 @@
---
-title: Microsoft's brand voice : above all, simple and human - Microsoft Style Guide
+title: Microsoft's brand voice; above all, simple and human - Microsoft Style Guide
description: Discusses Microsoft's brand voice, which is simple and human, such as "what" we say, our message, and "how" we say it, our voice.
author: pallep
ms.author: pallep
From ed810bb2cc0495e387c2f16c0abea20432e9fdd8 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 10:48:03 -0500
Subject: [PATCH 273/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 35bd8044..3f7de9c9 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -20,7 +20,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| June 24, 2022 | [Colons](/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
| June 24, 2022 | [Nouns and pronouns](/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
| June 24, 2022 | [Person](/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
-| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
+| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples to address gaps in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
| May 13, 2022 | [phone, phone number](/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
From 9ee664b1f8e0f469b0c313f0a90938cd03bd4fa6 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 18 Oct 2022 11:18:16 -0500
Subject: [PATCH 274/486] Update bias-free-communication.md
---
styleguide/bias-free-communication.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md
index 2ab93456..5fa5cce7 100644
--- a/styleguide/bias-free-communication.md
+++ b/styleguide/bias-free-communication.md
@@ -3,7 +3,7 @@ title: Bias-free communication - Microsoft Style Guide
description: Describes Microsoft's prioritization of inclusive language and communication being used in content and provides terms to use and avoid in all content.
author: pallep
ms.author: pallep
-ms.date: 08/25/2021
+ms.date: 10/18/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -89,10 +89,10 @@ countries with states or continents.
| perimeter network | demilitarized zone (DMZ) |
| stop responding | hang |
-**Focus on people, not disabilities.** For example, talk about readers who are blind or have low vision and customers with limited dexterity. Don't use words that imply pity, such as *stricken with* or *suffering from.* Don't mention a disability unless it's relevant. For more information, see the [Accessibility term collection](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
+**Focus on people, not disabilities.** For example, talk about readers who are blind or have low vision and customers with limited dexterity. Don't use words that imply pity, such as *stricken with* or *suffering from.* Don't mention a disability unless it's relevant. For more information, see the [Accessibility term collection](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms).
**Inclusive language** Use title-style capitalization for Asian, Black and African American, Hispanic and Latinx, Native American, Alaska Native, Native Hawaiian, Pacific Islander, and Indigenous Peoples. Microsoft style is to lowercase multiracial and white.
**Learn more** For more information about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
-**See also** [Accessibility guidelines and requirements](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/accessibility/accessibility-guidelines-requirements.md), [Global communications](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/global-communications/index.md)
+**See also** [Accessibility guidelines and requirements](https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements), [Global communications](https://learn.microsoft.com/en-us/style-guide/global-communications/)
From 1d4d16cd625d36a3f9a2a8750029d384a8176748 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 15:19:05 -0500
Subject: [PATCH 275/486] Update acronyms.md
---
styleguide/acronyms.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/acronyms.md b/styleguide/acronyms.md
index 0de84671..d9c2f0a5 100644
--- a/styleguide/acronyms.md
+++ b/styleguide/acronyms.md
@@ -3,7 +3,7 @@ title: Acronyms - Microsoft Style Guide
description: This article describes how to write acronyms and abbreviations per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/19/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -11,7 +11,7 @@ ms.prod: non-product-specific
# Acronyms
Acronyms and abbreviations can have an adverse effect on clarity, voice, and
-SEO. Although some acronyms are widely understood and preferred to the
+findability. Although some acronyms are widely understood and preferred to the
spelled-out term, others aren't well known or are familiar only to a
specific group of customers.
From c7b1de2565de1d083a309babe3ba843ff24b5071 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 15:24:08 -0500
Subject: [PATCH 276/486] Update describing-alternative-input-methods.md
---
.../describing-alternative-input-methods.md | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/styleguide/procedures-instructions/describing-alternative-input-methods.md b/styleguide/procedures-instructions/describing-alternative-input-methods.md
index 7a953d5a..586898b3 100644
--- a/styleguide/procedures-instructions/describing-alternative-input-methods.md
+++ b/styleguide/procedures-instructions/describing-alternative-input-methods.md
@@ -3,7 +3,7 @@ title: Describing alternative input methods - Microsoft Style Guide
description: Discusses using input-neutral methods in instructions and providing an article that explains how to interact with the product using each available input method.
author: pallep
ms.author: pallep
-ms.date: 09/3/2019
+ms.date: 10/19/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -69,10 +69,10 @@ other considerations. Some approaches are discussed below.
**Choose colors to use on webpages**
To make webpages easier to see, you can change the text, background, link, and hover colors in Internet Explorer.
-| **Step** | **Mouse actions** | **Keyboard actions** |
-|---|---|---|
-| **1** | On the **Start** menu:
Click **Internet Explorer**.
| Display the **Start** menu by pressing the Windows logo key:
Select **Internet Explorer** by using the arrow keys, and then press **Enter**.
| Display the **Start** menu by pressing the Windows logo key:
Select **Internet Explorer** by using the arrow keys, and then press **Enter**.
|
+|In Internet Explorer:
Click the **Tools** menu.
Click **Internet Options**.
| In Internet Explorer:
Select the **Tools** menu by pressing **Alt+T**.
Select **Internet Options** by pressing **O**.
|
**Document the primary input method,** and provide the alternative instructions in parentheses or separate sentences after the main instructions.
**Examples**
From c0a9d86fe1fdd1dd7c22a98263499fd9e46b9846 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 15:41:44 -0500
Subject: [PATCH 277/486] Update download.md
---
styleguide/a-z-word-list-term-collections/d/download.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/download.md b/styleguide/a-z-word-list-term-collections/d/download.md
index e2b694a9..63e3d26c 100644
--- a/styleguide/a-z-word-list-term-collections/d/download.md
+++ b/styleguide/a-z-word-list-term-collections/d/download.md
@@ -12,9 +12,7 @@ ms.prod: non-product-specific
Use *download* to describe the intentional transfer of data and files to a system or device. Use *install* to describe adding apps, hardware, and drivers to a device.
-When you use *download* as a verb, describe what the customer is transferring *and* where the customer is transferring it *to.* In
-grammatical terms, use both a subject (the thing to be downloaded) and
-an object (the thing the subject is downloaded to) with the verb *download.*
+When you use *download* as a verb, describe what the customer is transferring *and* where the customer is transferring it *to.*
Don't use *download* to describe the process of opening, viewing, or switching to a webpage.
From ca7123f2fcad7dd79162c527cd4f01e8b3a0211b Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 15:41:57 -0500
Subject: [PATCH 278/486] Update download.md
---
styleguide/a-z-word-list-term-collections/d/download.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/download.md b/styleguide/a-z-word-list-term-collections/d/download.md
index 63e3d26c..88f7afe3 100644
--- a/styleguide/a-z-word-list-term-collections/d/download.md
+++ b/styleguide/a-z-word-list-term-collections/d/download.md
@@ -3,7 +3,7 @@ title: download - Microsoft Style Guide
description: Describes guidelines to use 'download' in Microsoft documents and provides alternate examples. See also 'install.'
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/19/2022
ms.topic: article
ms.prod: non-product-specific
---
From fc198b65326edf5c0501fe05942ccad7679c4ce9 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 16:01:21 -0500
Subject: [PATCH 279/486] Update describing-interactions-with-ui.md
---
.../describing-interactions-with-ui.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/procedures-instructions/describing-interactions-with-ui.md b/styleguide/procedures-instructions/describing-interactions-with-ui.md
index acd698fe..c5afba9e 100644
--- a/styleguide/procedures-instructions/describing-interactions-with-ui.md
+++ b/styleguide/procedures-instructions/describing-interactions-with-ui.md
@@ -3,7 +3,7 @@ title: Describing interactions with UI - Microsoft Style Guide
description: Describes how to refer to various interactions with UI and provides a table that outlines various verbs to use and examples of how to use them in content.
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 10/19/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -26,7 +26,7 @@ input method. Don't use input-specific verbs, such as *click* or *swipe*. Instea
| **Go to** |
Opening a menu.
Going to a tab or another particular place in the UI.
Going to a website or webpage.
It's OK to use On theXXXtab if the instruction is brief and continues immediately.
|
Go to Search :::image type="icon" source="media/describing-interactions-with-ui/721771267.png":::, enter the word settings, and then select Settings.
Go to File, and then select Close.
On the ribbon, go to the Design tab.
Go to the Deploy tab. In the Configuration list …
On the Deploy tab, in the Configuration list …
Go to Example.com to register.
|
| **Select** | Instructing the customer to select a specific item, including:
Selecting an option, such as a button.
Selecting a checkbox.
Selecting a value from a list box.
Selecting link text to go to a link.
Selecting an item on a menu or shortcut menu.
Selecting an item from a gallery.
Selecting keys and keyboard shortcuts. (Document keyboard shortcuts only if they're the most likely way the customer will accomplish a task or as an alternative input method, usually in a separate keyboard shortcuts article.)
|
Select the Modify button.
For Alignment, select Left.
Select the text, open the shortcut menu, and then select Font.
Select Open in new tab.
Select the LinkName link.
Select **F5**.
Select **Shift+Enter**.
Select **Ctrl+Alt+Delete**.
|
| **Select and hold, select and hold (or right-click)** | Use to describe pressing and holding an element in the UI. It's OK to use *right-click* with *select and hold* when the instruction isn't specific to touch devices. |
To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.
Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.
Select and hold (or right-click) the **Start** :::image type="icon" source="media/describing-interactions-with-ui/967781121.png"::: button, and then select **Device Manager**.
|
-| **>** | Use a greater-than symbol (>) to separate sequential steps.
Only use this approach when there's a clear and obvious path through the UI and the selection method is the same for each step. For example, don't mix things that require opening, selecting, and choosing.
Don't bold the greater-than symbol. Include a space before and after the symbol. | Select **Accounts > Other accounts > Add an account**. |
+| **>** | Use a greater-than symbol (>) to separate sequential steps.
Only use this approach when there's a clear and obvious path through the UI and the selection method is the same for each step. For example, don't mix things that require opening, selecting, and choosing.
Don't bold the greater-than symbol. Include a space before and after the symbol. | Select **Accounts** > **Other accounts** > **Add an account**. |
| **Clear** | Clearing the selection from a checkbox. | Clear the **Header row** checkbox. |
| **Choose** | Choosing an option, based on the customer's preference or desired outcome. | On the **Font** tab, choose the effects you want. |
| **Switch, turn on, turn off** | Turning a toggle key or toggle switch on or off. |
Use the **Caps lock** key to switch from typing capital letters to typing lowercase letters.
To switch between Normal, Outline, and Slide Sorter views, use the buttons on the View tab.
To make text and apps easier to see, turn on the toggle under Turn on high contrast.
To keep all applied filters, turn on the Pass all filters toggle.
|
From ceeaa0a5419cdd440e9d3a45b404d703713817d2 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 17:13:18 -0500
Subject: [PATCH 280/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3f7de9c9..9a09d665 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -27,7 +27,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| December 15, 2021 | [Cloud-computing terms](/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
| December 9, 2021 | [SQL, SQL server](/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
-| August 26, 2021 | [touch-sensitive](/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
+| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
| August 25, 2021 | [Bias-free communication](/style-guide/bias-free-communication) | Added inclusive language section.
| August 12, 2021 | [colons](/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](/style-guide/numbers) | Replaced colons with ratio symbols.
From 71d74d1183b90bccd8c6f9665ffcb509a715b0c8 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 17:14:10 -0500
Subject: [PATCH 281/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 9a09d665..3cc07f69 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -26,7 +26,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| May 13, 2022 | [phone, phone number](/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
| December 15, 2021 | [Cloud-computing terms](/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
| December 9, 2021 | [SQL, SQL server](/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
-| August 26, 2021 | [multi-](/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
+| August 26, 2021 | [multi-](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
| August 25, 2021 | [Bias-free communication](/style-guide/bias-free-communication) | Added inclusive language section.
| August 12, 2021 | [colons](/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
From 2419cb0525dd2ae2a3fbe3869204c6e8f7f524ba Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 17:17:05 -0500
Subject: [PATCH 282/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3cc07f69..3643d3a4 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,16 +16,16 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
-| June 24, 2022 | [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Colons](/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Nouns and pronouns](/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
-| June 24, 2022 | [Person](/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
-| May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples to address gaps in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
-| May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
-| May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers.
-| May 13, 2022 | [phone, phone number](/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
-| December 15, 2021 | [Cloud-computing terms](/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
-| December 9, 2021 | [SQL, SQL server](/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
+| June 24, 2022 | [Date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns](https://learn.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person](https://learn.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
+| May 13, 2022 | [Lists](https://learn.microsoft.com/en-us/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples to address gaps in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
+| May 13, 2022 | [Periods](https://learn.microsoft.com/en-us/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
+| May 13, 2022 | [Numbers](https://learn.microsoft.com/en-us/style-guide/numbers) | Added new section on phone numbers.
+| May 13, 2022 | [phone, phone number](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
+| December 15, 2021 | [Cloud-computing terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
+| December 9, 2021 | [SQL, SQL server](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
| August 25, 2021 | [Bias-free communication](/style-guide/bias-free-communication) | Added inclusive language section.
From ec3d3e4eb12a9ddc63ab317a0b0b41a611b06770 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 17:19:47 -0500
Subject: [PATCH 283/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3643d3a4..48a018da 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -28,10 +28,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| December 9, 2021 | [SQL, SQL server](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
| August 26, 2021 | [multi-](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
-| August 25, 2021 | [Bias-free communication](/style-guide/bias-free-communication) | Added inclusive language section.
-| August 12, 2021 | [colons](/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
-| August 11, 2021 | [numbers](/style-guide/numbers) | Replaced colons with ratio symbols.
-| August 10, 2021 | [date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
+| August 25, 2021 | [Bias-free communication](https://learn.microsoft.com/en-us/style-guide/bias-free-communication) | Added inclusive language section.
+| August 12, 2021 | [colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
+| August 11, 2021 | [numbers](https://learn.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
+| August 10, 2021 | [date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
From cf978d14ffa24902e72f6ae93309974c6019a534 Mon Sep 17 00:00:00 2001
From: S-LRaillard <114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 19 Oct 2022 17:22:18 -0500
Subject: [PATCH 284/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 48a018da..6e5f177e 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -32,17 +32,17 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| August 12, 2021 | [colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
| August 11, 2021 | [numbers](https://learn.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
| August 10, 2021 | [date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
-| May 31, 2021 | [workstream](~/a-z-word-list-term-collections/w/workstream.md) | New guidance on spelling and use.
-| May 31, 2021 | [wellbeing](~/a-z-word-list-term-collections/w/wellbeing.md) | New guidance on spelling and use.
-| April 30, 2021 | [invite](~/a-z-word-list-term-collections/i/invite.md) | New topic.
-| April 30, 2021 | [dark mode](~/a-z-word-list-term-collections/d/dark-mode.md) | New topic.
-| April 30, 2021 | [SMB](~/a-z-word-list-term-collections/s/smb.md) | New topic.
-| March 31, 2021 | [bits and bytes](~/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md) | Updated guidance on when to abbreviate certain terms.
-| March 31, 2021 | [dialog box, dialog, dialogue](~/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue.md) | Updated guidance on use.
+| May 31, 2021 | [workstream](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/w/workstream) | New guidance on spelling and use.
+| May 31, 2021 | [wellbeing](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/w/wellbeing) | New guidance on spelling and use.
+| April 30, 2021 | [invite](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/i/invite) | New topic.
+| April 30, 2021 | [dark mode](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dark-mode) | New topic.
+| April 30, 2021 | [SMB](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/smb) | New topic.
+| March 31, 2021 | [bits and bytes](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/bits-bytes-terms) | Updated guidance on when to abbreviate certain terms.
+| March 31, 2021 | [dialog box, dialog, dialogue](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue) | Updated guidance on use.
| March 29, 2021 | [check, checkbox, check mark](~/a-z-word-list-term-collections/c/check-checkbox-check-mark.md) | Updated guidance on use.
-| March 26, 2021 | [dropdown](~/a-z-word-list-term-collections/d/dropdown.md) | Updated guidance on spelling and use.
-| March 16, 2021 | [Welcome page](~/welcome/index.md) | Updated Welcome page.
-| January 15, 2021 | [blacklist](~/a-z-word-list-term-collections/b/blacklist.md) | Updated guidance on spacing for alternative term, *blocklist*.
+| March 26, 2021 | [dropdown](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dropdown) | Updated guidance on spelling and use.
+| March 16, 2021 | [Welcome page](https://learn.microsoft.com/en-us/style-guide/welcome/) | Updated Welcome page.
+| January 15, 2021 | [blacklist](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/blacklist) | Updated guidance on spacing for alternative term, *blocklist*.
| January 15, 2021 | [environment variable](~/a-z-word-list-term-collections/e/environment-variable.md) | Updated topic guidance.
| January 15, 2021 | [whitelist](~/a-z-word-list-term-collections/w/whitelist.md) | Updated guidance on spacing for alternative term, *allowlist*.
| November 24, 2020 | [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md) | Updated topic to include guidance on using words such as "see", "read", and "look".
From f1d56b796df8936575403b61cfe6bed7f874c3c3 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 26 Oct 2022 10:57:15 -0500
Subject: [PATCH 285/486] Update sign-in-sign-out.md
---
.../a-z-word-list-term-collections/s/sign-in-sign-out.md | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md b/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
index bb06a245..3d1ad28c 100644
--- a/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
+++ b/styleguide/a-z-word-list-term-collections/s/sign-in-sign-out.md
@@ -3,7 +3,7 @@ title: sign in, sign out - Microsoft Style Guide
description: Describes guidelines to use 'sign in' or 'sign out' in Microsoft documents, and provides usage examples.
author: pallep
ms.author: pallep
-ms.date: 06/27/2019
+ms.date: 10/26/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -23,6 +23,5 @@ The verb form is two words, *sign in* or *sign out.* Avoid using as a noun or ad
Enter your password to sign in.
Learn how to sign in to Power BI service on the web and how to sign out of it.
After an extended period without activity, the network will sign you out automatically.
-Some networks can be set up to remember your username and password.
**See also** [connect](~/a-z-word-list-term-collections/c/connect.md), [single sign-on (SSO)](~/a-z-word-list-term-collections/s/single-sign-on-sso.md)
From a2ac515356f116fbcb94277e6da267375b355496 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Dec 2022 15:55:14 -0600
Subject: [PATCH 286/486] Update emes.md
---
styleguide/punctuation/dashes-hyphens/emes.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/punctuation/dashes-hyphens/emes.md b/styleguide/punctuation/dashes-hyphens/emes.md
index 141a1af7..f5ffa797 100644
--- a/styleguide/punctuation/dashes-hyphens/emes.md
+++ b/styleguide/punctuation/dashes-hyphens/emes.md
@@ -3,7 +3,7 @@ title: Em dashes - Microsoft Style Guide
description: Instructs to use an em dash (-) to set off a parenthetical phrase with more emphasis than parenthesis provide. Don't add spaces around a em dash.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 12/06/2022
ms.topic: article
ms.prod: non-product-specific
---
@@ -19,7 +19,7 @@ dash.
**Example**
The information in your spreadsheet—numbers, formulas, and text—is stored in cells.
- - Use one em dash to set off a phrase at the end of a sentence.
+ - Use one em dash to set off a phrase or clause at the end of a sentence.
**Example**
If you're not sure about the details, look at the illustrations in the wizard—they can help you figure out what type of connection you’re using.
From 057600112538520dc9b6046385eececdd7ffcb5a Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 14 Dec 2022 12:03:06 -0600
Subject: [PATCH 287/486] Update keys-keyboard-shortcuts.md
---
.../term-collections/keys-keyboard-shortcuts.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
index d478012a..f087495e 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
@@ -3,7 +3,7 @@ title: Keys and keyboard shortcuts - Microsoft Style Guide
description: Describes how to refer to keys and keyboard shortcuts in Microsoft content and provides a list that outlines usage for various keyboard actions and access.
author: pallep
ms.author: pallep
-ms.date: 09/3/2019
+ms.date: 12/13/2022
ms.topic: article
ms.prod: non-product-specific
---
From 5176c2b8fb900c1ccf7a77254f76bae9d21dd728 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 4 Jan 2023 12:44:02 -0600
Subject: [PATCH 288/486] Update formatting-text-in-instructions.md
---
.../formatting-text-in-instructions.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md
index 9365e7bf..bdd59453 100644
--- a/styleguide/procedures-instructions/formatting-text-in-instructions.md
+++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md
@@ -3,7 +3,7 @@ title: Formatting text in instructions - Microsoft Style Guide
description: Discusses that consistent text formatting helps readers locate and interpret information, such as instructions.
author: pallep
ms.author: pallep
-ms.date: 10/18/2022
+ms.date: 01/04/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -35,7 +35,7 @@ Use these conventions in instructions that appear in documentation and technical
| **Commands** | Use bold formatting for command names. Use sentence-style capitalization unless you need to match the UI. If a command label ends with a colon or an ellipsis, don't include that end punctuation in instructions. Don't include the word *command* unless it adds needed clarity. | Go to **Tools**, and select **Change language**. On the **Design** menu, select **Colors**, and then select a color scheme. |
| **Database names** | Bold. The capitalization of database names varies. | **WingtipToys** database |
| **Device and port names** | All uppercase. | USB |
-| **Dialog boxes** | In general, avoid talking about UI. Instead, talk about what the customer needs to do. When you need to refer to the UI element, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*. When you must refer to a dialog by name, use bold formatting for its name. Use sentence-style capitalization unless you need to match the UI. If a dialog label ends with a colon or an ellipsis, don't include that end punctuation in instructions. | Select **Upload**, and then select a file to upload. In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**. In the **Protect document** dialog box, clear the **Shapes** checkbox. |
+| **Dialog boxes** | In general, avoid talking about UI. Instead, talk about what the customer needs to do. When you need to refer to the UI element, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*. When you must refer to a dialog by name, use bold formatting for its name. Use sentence-style capitalization unless you need to match the UI. If a dialog label ends with a colon or an ellipsis, don't include that end punctuation in instructions. | Select **Upload**, and then select a file to upload. In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**. In the **Protect document** dialog, clear the **Shapes** checkbox. |
| **Error messages** | Sentence-style capitalization. Enclose error messages in quotation marks when referring to them in text. | We can't find a scanner. Hmm ... looks like that's a broken link. If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device. |
| **File attributes** | All lowercase. | To remove the hidden attribute from all files in a folder .... |
| **File name extensions** | All lowercase. | .mdb .doc |
From 47e3b2bc69bd1a4642633560b598eeeb5f0b4680 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 4 Jan 2023 12:48:38 -0600
Subject: [PATCH 289/486] Update formatting-text-in-instructions.md
---
.../procedures-instructions/formatting-text-in-instructions.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md
index bdd59453..742f9c2d 100644
--- a/styleguide/procedures-instructions/formatting-text-in-instructions.md
+++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md
@@ -36,7 +36,7 @@ Use these conventions in instructions that appear in documentation and technical
| **Database names** | Bold. The capitalization of database names varies. | **WingtipToys** database |
| **Device and port names** | All uppercase. | USB |
| **Dialog boxes** | In general, avoid talking about UI. Instead, talk about what the customer needs to do. When you need to refer to the UI element, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*. When you must refer to a dialog by name, use bold formatting for its name. Use sentence-style capitalization unless you need to match the UI. If a dialog label ends with a colon or an ellipsis, don't include that end punctuation in instructions. | Select **Upload**, and then select a file to upload. In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**. In the **Protect document** dialog, clear the **Shapes** checkbox. |
-| **Error messages** | Sentence-style capitalization. Enclose error messages in quotation marks when referring to them in text. | We can't find a scanner. Hmm ... looks like that's a broken link. If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device. |
+| **Error messages** | Sentence-style capitalization. Enclose error messages in quotation marks when referring to them in text. | Hmm ... looks like that's a broken link. If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device. |
| **File attributes** | All lowercase. | To remove the hidden attribute from all files in a folder .... |
| **File name extensions** | All lowercase. | .mdb .doc |
| **File names (user-defined examples)** | Title-style capitalization. It's OK to use internal capital letters in file names for readability. Use bold formatting for file names in procedures if you're directing the customer to select, type, or otherwise interact with the name. | My Taxes for 2016 MyTaxesFor2016 Enter **MyTaxesFor2016**. |
From 772b36e58e6cfca17b3430a91d59de8083ede5a6 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 25 Jan 2023 16:10:59 -0600
Subject: [PATCH 290/486] Update mouse-mouse-interaction-terms.md
---
.../term-collections/mouse-mouse-interaction-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
index ccbe4cb4..bd1c8c65 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
@@ -13,7 +13,7 @@ ms.prod: non-product-specific
Most
of the time, don't talk about the mouse, mouse actions, or the pointer
unless it's necessary to avoid confusion. Instead, talk about
-customer interactions with the UI. To learn more, see [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md).
+customer interactions with the UI. To learn more, see [Describing interactions with UI]([(https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui]).
When you need to talk specifically about the mouse, mouse interactions, or the pointer, use these terms.
From 9d5649b8e48b91f2199471266ac6cad04a961bc1 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 25 Jan 2023 16:11:23 -0600
Subject: [PATCH 291/486] Update mouse-mouse-interaction-terms.md
---
.../term-collections/mouse-mouse-interaction-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
index bd1c8c65..c20b0af4 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
@@ -13,7 +13,7 @@ ms.prod: non-product-specific
Most
of the time, don't talk about the mouse, mouse actions, or the pointer
unless it's necessary to avoid confusion. Instead, talk about
-customer interactions with the UI. To learn more, see [Describing interactions with UI]([(https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui]).
+customer interactions with the UI. To learn more, see [Describing interactions with UI](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui).
When you need to talk specifically about the mouse, mouse interactions, or the pointer, use these terms.
From ebc9639c39e3205e82857b6c933a6d097b42b4d3 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 25 Jan 2023 16:11:50 -0600
Subject: [PATCH 292/486] Update mouse-mouse-interaction-terms.md
---
.../term-collections/mouse-mouse-interaction-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
index c20b0af4..06a2f5a2 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md
@@ -3,7 +3,7 @@ title: Mouse and mouse interaction terms - Microsoft Style Guide
description: Describes how to refer the mouse and mouse interaction and provides a table that outlines the usage of various mouse-related terms.
author: pallep
ms.author: pallep
-ms.date: 9/21/2019
+ms.date: 01/25/2023
ms.topic: article
ms.prod: non-product-specific
---
From ff91d749d46d2d14635c9a6de002419185855426 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 25 Jan 2023 16:17:36 -0600
Subject: [PATCH 293/486] Update describing-alternative-input-methods.md
---
.../describing-alternative-input-methods.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/procedures-instructions/describing-alternative-input-methods.md b/styleguide/procedures-instructions/describing-alternative-input-methods.md
index 586898b3..3f6dcb10 100644
--- a/styleguide/procedures-instructions/describing-alternative-input-methods.md
+++ b/styleguide/procedures-instructions/describing-alternative-input-methods.md
@@ -71,8 +71,8 @@ To make webpages easier to see, you can change the text, background, link, and h
| **Mouse actions** | **Keyboard actions** |
|---|---|
-|On the **Start** menu:
Click **Internet Explorer**.
| Display the **Start** menu by pressing the Windows logo key:
Select **Internet Explorer** by using the arrow keys, and then press **Enter**.
|
-|In Internet Explorer:
Click the **Tools** menu.
Click **Internet Options**.
| In Internet Explorer:
Select the **Tools** menu by pressing **Alt+T**.
Select **Internet Options** by pressing **O**.
|
+|On the **Start** menu:
Click **Internet Explorer**.
| Display the **Start** menu by pressing the Windows logo key:
Select **Internet Explorer** by using the arrow keys, and then press **Enter**.
|
+|In Internet Explorer: 1. Click the **Tools** menu. 2. Click **Internet Options**.
| In Internet Explorer: 1. Select the **Tools** menu by pressing **Alt+T**. 2. Select **Internet Options** by pressing **O**.
|
**Document the primary input method,** and provide the alternative instructions in parentheses or separate sentences after the main instructions.
**Examples**
From 4aa235463001e0a8537ae75468839429e1b689df Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 13 Feb 2023 09:19:52 -0600
Subject: [PATCH 294/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 6e5f177e..f1694c9f 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 10/18/2022
+ms.date: 02/12/2023
ms.topic: article
ms.prod: non-product-specific
---
From e9e544a2a2445a663ab42858879d4f1e60d35eb8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 13 Feb 2023 09:20:13 -0600
Subject: [PATCH 295/486] Update index.md
---
styleguide/welcome/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/index.md b/styleguide/welcome/index.md
index b06f5a09..3a121d4d 100644
--- a/styleguide/welcome/index.md
+++ b/styleguide/welcome/index.md
@@ -3,7 +3,7 @@ title: Welcome - Microsoft Style Guide
description: The online Microsoft Writing Style Guide provides up-to-date style and terminology guidelines. It replaces the Microsoft Manual of Style.
author: pallep
ms.author: pallep
-ms.date: 01/27/2022
+ms.date: 02/12/2023
ms.topic: article
ms.prod: non-product-specific
---
From 4892f8f4c5a67646e71301aa327c72587ac8bab0 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:10:38 -0600
Subject: [PATCH 296/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 54 +++++++++----------
1 file changed, 24 insertions(+), 30 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index cbf82e70..d6384422 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -3,48 +3,42 @@ title: Accessibility terms - Microsoft Style Guide
description: Describes accessibility terms and provides examples of inclusive language to include in content and examples of sensitive language to exclude from content.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 02/22/2023
ms.topic: article
ms.prod: non-product-specific
---
# Accessibility terms
-Write in a way that puts people first by using the phrase *person with* or *person who.*
+In general, use people-first language (refer first to the person, followed by the disability). To ensure clarity and consistency, this should be the default unless you know a specific audience prefers otherwise.
-Don’t use language that defines people by their disability, such as *disabled, impaired,* and *the deaf.* A person might have a visual impairment, but that person isn’t impaired.
+In some cases, however, identity-first language can be used, because some people and communities take pride in recognizing their disability as an integral part of their identity and feel that person-first language is marginalizing. Always make an effort to know the preferences expressed by a person with a disability or a disability community and defer to these.
-**Examples**
-Person with visual impairment, person who is blind
-Person with hearing loss, person with deafness
-Person who is nonverbal, person who uses sign language
-Person who uses a wheelchair
-Person with a prosthetic limb, person without a limb
-Person with autism
-Person of small stature
+In all cases, don’t use language that has offensive or insensitive connotations, such as *maimed* or *impaired*.
-It's OK to use words such as *see*, *read*, and *look* when calling out an example or another reference.
+The following table lists examples of people-first language (preferred), identity-first language (acceptable, context-dependent), and offensive or insensitive language (never allowed).
+ **Preferred (people-first)** | **Acceptable (identity-first)** | **Do not use (offensive/insensitive)** |
+|----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Person who is blind, person with low vision | Blind person | Sight-impaired, vision-impaired |
+| Person who is deaf, person with a hearing disability | Deaf person | Hearing-impaired |
+| Person with limited mobility, person who has a mobility or physical disability | Physically disabled person, wheelchair user | Crippled, lame, handicapped |
+| Is unable to speak, uses sign language, uses synthetic speech* | | Dumb, mute, non-verbal |
+| **File name extensions** | All lowercase. | .mdb .doc |
+| **File names** | Title-style capitalization. It's OK to use internal caps in file names for readability. | My Taxes for 2016 MyTaxesFor2016 |
+| **Folder and directory names** | Sentence-style capitalization. It's OK to use internal capital letters in folder and directory names for readability. | Vacation and sick pay MyFiles\Accounting\Payroll\VacPay |
+| **Macros** | Usually all uppercase. Use bold formatting if predefined. Might be monospace if user defined. Treatment varies. | **LOWORD** `MASKROP` |
+| **Markup language elements (tags)** | Bold. Capitalization varies. | **\** **\** **\** |
+| **Mathematical constants and variables** | Italic. | *a2 + b2 = c2* |
+| **New terms** | Italicize the first mention of a new term if you're going to define it immediately in text. | Microsoft Exchange consists of both *server* and *client* components. |
+| **Ports** | All uppercase. | LPT1 |
+| **Products, services, apps, and trademarks** | Usually title-style capitalization. Check the [Microsoft trademark list](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/en-us.aspx) for capitalization of trademarked names. | Microsoft Arc Touch Mouse Microsoft Word Surface Pro Notepad Network Connections |
+| **UI text or strings** | Sentence-style capitalization. | Find on page Read aloud Hide selected items |
+| **URLs** | All lowercase for complete URLs. If necessary, line-break long URLs before a slash. Don't hyphenate. **See also** [URLs and web addresses](../urls-web-addresses.md) | www.microsoft.com msdn.microsoft.com/downloads |
-**Example**
-For more information see [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
-If necessary, use the following terms to describe people with disabilities or the disabilities themselves.
For an overview of Microsoft accessibility policies, see [Accessibility guidelines and requirements](~/accessibility/accessibility-guidelines-requirements.md).
-To learn more about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
-
-
-| Use this | Instead of this |
-|-----------------------------------------------------------------------------------|-----------------------------------------------------------------------|
-| Blind, has low vision | Sight-impaired, vision-impaired |
-| Deaf or hard-of-hearing | Hearing-impaired |
-| Has limited mobility, has a mobility or physical disability | Crippled, lame |
-| Is unable to speak, uses synthetic speech | Dumb, mute |
-| Has multiple sclerosis, cerebral palsy, a seizure disorder, or muscular dystrophy | Affected by, stricken with, suffers from, a victim of, an epileptic |
-| Without disabilities | Normal, able-bodied, healthy |
-| Person with a prosthetic limb, person without a limb | Maimed, missing a limb |
-| People with disabilities | The disabled, disabled people, people with handicaps, the handicapped |
-| Cognitive disabilities, developmental disabilities | Slow learner, mentally handicapped, differently abled |
-| TTY (to refer to the telecommunication device) | TT/TTD |
+For more information see [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
+To learn more about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
From 7d6b3585db4cdb848501502973cff2f9fef96ba2 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:15:26 -0600
Subject: [PATCH 297/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index d6384422..9dadb7aa 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -23,12 +23,12 @@ The following table lists examples of people-first language (preferred), identit
| Person who is deaf, person with a hearing disability | Deaf person | Hearing-impaired |
| Person with limited mobility, person who has a mobility or physical disability | Physically disabled person, wheelchair user | Crippled, lame, handicapped |
| Is unable to speak, uses sign language, uses synthetic speech* | | Dumb, mute, non-verbal |
-| **File name extensions** | All lowercase. | .mdb .doc |
-| **File names** | Title-style capitalization. It's OK to use internal caps in file names for readability. | My Taxes for 2016 MyTaxesFor2016 |
-| **Folder and directory names** | Sentence-style capitalization. It's OK to use internal capital letters in folder and directory names for readability. | Vacation and sick pay MyFiles\Accounting\Payroll\VacPay |
-| **Macros** | Usually all uppercase. Use bold formatting if predefined. Might be monospace if user defined. Treatment varies. | **LOWORD** `MASKROP` |
-| **Markup language elements (tags)** | Bold. Capitalization varies. | **\** **\** **\** |
-| **Mathematical constants and variables** | Italic. | *a2 + b2 = c2* |
+| Has multiple sclerosis, cerebral palsy, a seizure disorder, or muscular dystrophy | | Affected by, stricken with, suffers from, a victim of, an epileptic |
+| Person without a disability | Non-disabled person, able-bodied person | Normal person, healthy person |
+| Person with a prosthetic limb, person with a limb difference, person with an amputation | Amputee | Maimed, missing a limb, birth defect |
+| Person with a disability | Disabled person | People with handicaps, the handicapped |
+| Person with cognitive disabilities, developmental disabilities, learning disabilities, or dyslexia | Learning disabled, dyslexic person | Slow learner, mentally handicapped, differently abled, Special Ed person, stupid |
+| Person with autism, person with neurodiversity | Autistic person, neurodiverse person | Asperger’s |
| **New terms** | Italicize the first mention of a new term if you're going to define it immediately in text. | Microsoft Exchange consists of both *server* and *client* components. |
| **Ports** | All uppercase. | LPT1 |
| **Products, services, apps, and trademarks** | Usually title-style capitalization. Check the [Microsoft trademark list](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/en-us.aspx) for capitalization of trademarked names. | Microsoft Arc Touch Mouse Microsoft Word Surface Pro Notepad Network Connections |
From aa4f27afc905ed3a77084be19b6782adb751e94a Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:16:23 -0600
Subject: [PATCH 298/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 6 ------
1 file changed, 6 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index 9dadb7aa..19d0f86e 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -29,12 +29,6 @@ The following table lists examples of people-first language (preferred), identit
| Person with a disability | Disabled person | People with handicaps, the handicapped |
| Person with cognitive disabilities, developmental disabilities, learning disabilities, or dyslexia | Learning disabled, dyslexic person | Slow learner, mentally handicapped, differently abled, Special Ed person, stupid |
| Person with autism, person with neurodiversity | Autistic person, neurodiverse person | Asperger’s |
-| **New terms** | Italicize the first mention of a new term if you're going to define it immediately in text. | Microsoft Exchange consists of both *server* and *client* components. |
-| **Ports** | All uppercase. | LPT1 |
-| **Products, services, apps, and trademarks** | Usually title-style capitalization. Check the [Microsoft trademark list](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/en-us.aspx) for capitalization of trademarked names. | Microsoft Arc Touch Mouse Microsoft Word Surface Pro Notepad Network Connections |
-| **UI text or strings** | Sentence-style capitalization. | Find on page Read aloud Hide selected items |
-| **URLs** | All lowercase for complete URLs. If necessary, line-break long URLs before a slash. Don't hyphenate. **See also** [URLs and web addresses](../urls-web-addresses.md) | www.microsoft.com msdn.microsoft.com/downloads |
-
For an overview of Microsoft accessibility policies, see [Accessibility guidelines and requirements](~/accessibility/accessibility-guidelines-requirements.md).
From 493de6d4e47758f9ff157b305266ae2bdd1c1e65 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:18:26 -0600
Subject: [PATCH 299/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 2 --
1 file changed, 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index 19d0f86e..c7c681cc 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -33,6 +33,4 @@ The following table lists examples of people-first language (preferred), identit
For an overview of Microsoft accessibility policies, see [Accessibility guidelines and requirements](~/accessibility/accessibility-guidelines-requirements.md).
-For more information see [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md).
-
To learn more about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
From 72a5d35c48dedec3326ffa6339335dab167e05ea Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:24:23 -0600
Subject: [PATCH 300/486] Create key performance indicator (KPI)
---
.../k/key performance indicator (KPI) | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
new file mode 100644
index 00000000..537481ab
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
@@ -0,0 +1,18 @@
+---
+title: key performance indicator (KPI) - Microsoft Style Guide
+description: Describes how to use the term "key performance indicator (KPI)" in Microsoft content.
+author: pallep
+ms.author: pallep
+ms.date: 02/22/2023
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# key performance indicator
+
+Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
+
+On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KPI*.
+
+In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
+**See also** key result (KR), objectives and key results (OKR)
From 27bcf4ea7b07d2ce29fc33ab8c01654149f37733 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:25:46 -0600
Subject: [PATCH 301/486] Update key performance indicator (KPI)
---
.../k/key performance indicator (KPI) | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
index 537481ab..344ade62 100644
--- a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
+++ b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
@@ -5,10 +5,10 @@ author: pallep
ms.author: pallep
ms.date: 02/22/2023
ms.topic: article
-ms.prod: non-product-specific
+**ms.prod: non-product-specific**
---
-# key performance indicator
+**# key performance indicator**
Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
From 0fcf477dea1395927539a8f353ece7f1212b2912 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:26:21 -0600
Subject: [PATCH 302/486] Update key performance indicator (KPI)
---
.../k/key performance indicator (KPI) | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
index 344ade62..537481ab 100644
--- a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
+++ b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
@@ -5,10 +5,10 @@ author: pallep
ms.author: pallep
ms.date: 02/22/2023
ms.topic: article
-**ms.prod: non-product-specific**
+ms.prod: non-product-specific
---
-**# key performance indicator**
+# key performance indicator
Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
From b9601fb2295e6dc9fee0357d6aa31552b5009d92 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:34:44 -0600
Subject: [PATCH 303/486] Update key performance indicator (KPI)
---
.../k/key performance indicator (KPI) | 11 +++--------
1 file changed, 3 insertions(+), 8 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
index 537481ab..28f19afa 100644
--- a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
+++ b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
@@ -1,6 +1,6 @@
---
title: key performance indicator (KPI) - Microsoft Style Guide
-description: Describes how to use the term "key performance indicator (KPI)" in Microsoft content.
+description: Describes how to use the terms "key performance indicator" and "KPI" in Microsoft content.
author: pallep
ms.author: pallep
ms.date: 02/22/2023
@@ -8,11 +8,6 @@ ms.topic: article
ms.prod: non-product-specific
---
-# key performance indicator
+# key performance indicator (KPI)
-Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
-
-On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KPI*.
-
-In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** key result (KR), objectives and key results (OKR)
+**See also** [key result (KR)](~), [objectives and key results (OKR)] (~)
From 4cf8400313da7955331c2fa4846dcb0d90c22db8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:35:36 -0600
Subject: [PATCH 304/486] Update key performance indicator (KPI)
---
.../k/key performance indicator (KPI) | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
index 28f19afa..d196f343 100644
--- a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
+++ b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
@@ -10,4 +10,10 @@ ms.prod: non-product-specific
# key performance indicator (KPI)
+Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
+
+On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KPI*.
+
+In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
+
**See also** [key result (KR)](~), [objectives and key results (OKR)] (~)
From 500fabdcdd0d6bef332f25adae286d7d8fb3646c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:41:11 -0600
Subject: [PATCH 305/486] Update TOC.md
---
styleguide/TOC.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 9ef02b9e..d0620d86 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -440,6 +440,7 @@
## K
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
+### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
From e3c9ffc7e7ea2f3f9d450096cc3ee7c407c25e7c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:46:36 -0600
Subject: [PATCH 306/486] Rename key performance indicator (KPI) to key
performance indicator (KPI).md
---
...ormance indicator (KPI) => key performance indicator (KPI).md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/k/{key performance indicator (KPI) => key performance indicator (KPI).md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI) b/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI).md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI)
rename to styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI).md
From 2b68ca4feda60ff0fd52ce19b38df30bf2f603fb Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:48:02 -0600
Subject: [PATCH 307/486] Create key result (KR).md
---
.../k/key result (KR).md | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/k/key result (KR).md
diff --git a/styleguide/a-z-word-list-term-collections/k/key result (KR).md b/styleguide/a-z-word-list-term-collections/k/key result (KR).md
new file mode 100644
index 00000000..5951aa5a
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/k/key result (KR).md
@@ -0,0 +1,17 @@
+---
+title: key result (KR) - Microsoft Style Guide
+description: Describes how to use the terms "key result" and "KR" in Microsoft content.
+author: pallep
+ms.author: pallep
+ms.date: 02/22/2023
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# key result (KR)
+
+Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
+
+On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KR*.
+
+**See also** [key performance indicator (KPI)](~), [objectives and key results (OKR)] (~)
From 09bf726964af29d037f408600554b27e193e70b0 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:49:20 -0600
Subject: [PATCH 308/486] Create objectives and key results (OKR).md
---
.../o/objectives and key results (OKR).md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md
diff --git a/styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md b/styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md
new file mode 100644
index 00000000..0189e806
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md
@@ -0,0 +1,19 @@
+---
+title: objectives and key results (OKR) - Microsoft Style Guide
+description: Describes how to use the terms "objectives and key results" and "OJR" in Microsoft content.
+author: pallep
+ms.author: pallep
+ms.date: 02/22/2023
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# objectives and key results (OKR)
+
+Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
+
+On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *OKR*.
+
+In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
+
+**See also** [key result (KR)](~), [key performance indicator (KPI)] (~)
From 7e34e5d319998e2a663d3f35fa129deadd4292e2 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:50:54 -0600
Subject: [PATCH 309/486] Update TOC.md
---
styleguide/TOC.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index d0620d86..a4b0fdc9 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -441,6 +441,7 @@
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
+### [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR).md)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
@@ -565,6 +566,7 @@
### [numeric](a-z-word-list-term-collections/n/numeric.md)
## O
### [object](a-z-word-list-term-collections/o/object.md)
+### [objectives and key results (OKR)](a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md)
### [obsolete](a-z-word-list-term-collections/o/obsolete.md)
### [of](a-z-word-list-term-collections/o/of.md)
### [offline](a-z-word-list-term-collections/o/offline.md)
From 8a88b5221db964c07db3c649f389f6663f10b002 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 11:57:15 -0600
Subject: [PATCH 310/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index a4b0fdc9..ae6c32c9 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -441,7 +441,7 @@
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
-### [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR).md)
+### [key result (KR)](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/7e34e5d319998e2a663d3f35fa129deadd4292e2/styleguide/a-z-word-list-term-collections/k/key%20result%20(KR).md)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
From 812754738325a32ce025ec86590075bc05c5c5c0 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 12:02:53 -0600
Subject: [PATCH 311/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index ae6c32c9..a4b0fdc9 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -441,7 +441,7 @@
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
-### [key result (KR)](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/7e34e5d319998e2a663d3f35fa129deadd4292e2/styleguide/a-z-word-list-term-collections/k/key%20result%20(KR).md)
+### [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR).md)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
From 39ad679ed668423e438b715909989a5574e9a4a5 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 12:06:05 -0600
Subject: [PATCH 312/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 1 -
1 file changed, 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index c7c681cc..d4007ff2 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -30,7 +30,6 @@ The following table lists examples of people-first language (preferred), identit
| Person with cognitive disabilities, developmental disabilities, learning disabilities, or dyslexia | Learning disabled, dyslexic person | Slow learner, mentally handicapped, differently abled, Special Ed person, stupid |
| Person with autism, person with neurodiversity | Autistic person, neurodiverse person | Asperger’s |
-
For an overview of Microsoft accessibility policies, see [Accessibility guidelines and requirements](~/accessibility/accessibility-guidelines-requirements.md).
To learn more about writing that conveys respect to all people and promotes equal opportunities, see the [Guidelines for Inclusive Language](https://www.linguisticsociety.org/content/guidelines-inclusive-language "Linguistic Society of America's guidelines for inclusive language") from the Linguistic Society of America.
From 95a300f4bad56ddaca88101eadbe5e2d617cc1d4 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:35:27 -0600
Subject: [PATCH 313/486] Delete key result (KR).md
---
.../k/key result (KR).md | 17 -----------------
1 file changed, 17 deletions(-)
delete mode 100644 styleguide/a-z-word-list-term-collections/k/key result (KR).md
diff --git a/styleguide/a-z-word-list-term-collections/k/key result (KR).md b/styleguide/a-z-word-list-term-collections/k/key result (KR).md
deleted file mode 100644
index 5951aa5a..00000000
--- a/styleguide/a-z-word-list-term-collections/k/key result (KR).md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: key result (KR) - Microsoft Style Guide
-description: Describes how to use the terms "key result" and "KR" in Microsoft content.
-author: pallep
-ms.author: pallep
-ms.date: 02/22/2023
-ms.topic: article
-ms.prod: non-product-specific
----
-
-# key result (KR)
-
-Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
-
-On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KR*.
-
-**See also** [key performance indicator (KPI)](~), [objectives and key results (OKR)] (~)
From 9e0f9571ad302073b7bd3069c9a780c34d9f6eaa Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:41:25 -0600
Subject: [PATCH 314/486] Create key result (KR).MD
---
.../k/key result (KR).MD | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/k/key result (KR).MD
diff --git a/styleguide/a-z-word-list-term-collections/k/key result (KR).MD b/styleguide/a-z-word-list-term-collections/k/key result (KR).MD
new file mode 100644
index 00000000..5951aa5a
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/k/key result (KR).MD
@@ -0,0 +1,17 @@
+---
+title: key result (KR) - Microsoft Style Guide
+description: Describes how to use the terms "key result" and "KR" in Microsoft content.
+author: pallep
+ms.author: pallep
+ms.date: 02/22/2023
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# key result (KR)
+
+Spell out on the first mention and include the abbreviation in parentheses immediately following the expanded form. Lowercase the spelled out term.
+
+On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KR*.
+
+**See also** [key performance indicator (KPI)](~), [objectives and key results (OKR)] (~)
From 05d0773c84ad7bd02acdc13aff2116001df9d672 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:42:48 -0600
Subject: [PATCH 315/486] Update TOC.md
---
styleguide/TOC.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index a4b0fdc9..e4965830 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -440,8 +440,8 @@
## K
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
-### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
-### [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR).md)
+### [key performance indicator (KPI)](~a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
+### [key result (KR)](~a-z-word-list-term-collections/k/key-result-(KR).md)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
From d42e0f4308af6b76618f5e7c8354a0605bcdd52b Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:45:38 -0600
Subject: [PATCH 316/486] Rename key result (KR).MD to key-result-(KR).MD
---
.../k/{key result (KR).MD => key-result-(KR).MD} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/k/{key result (KR).MD => key-result-(KR).MD} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/k/key result (KR).MD b/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/k/key result (KR).MD
rename to styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
From 6b96ad8e10ce6663f55e0cff7ba4b841ea37deb4 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:46:42 -0600
Subject: [PATCH 317/486] Update TOC.md
---
styleguide/TOC.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index e4965830..795eec9b 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -440,8 +440,8 @@
## K
### [Kerberos protocol](a-z-word-list-term-collections/k/kerberos-protocol.md)
### [key combination](a-z-word-list-term-collections/k/key-combination.md)
-### [key performance indicator (KPI)](~a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
-### [key result (KR)](~a-z-word-list-term-collections/k/key-result-(KR).md)
+### [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md)
+### [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR).MD)
### [key sequence](a-z-word-list-term-collections/k/key-sequence.md)
### [keyboard shortcut](a-z-word-list-term-collections/k/keyboard-shortcut.md)
### [keypad](a-z-word-list-term-collections/k/keypad.md)
From 397959a3d5dd185079da01d8feac752143ea5dab Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:47:53 -0600
Subject: [PATCH 318/486] Rename key performance indicator (KPI).md to
key-performance-indicator-(KPI).md
---
...ance indicator (KPI).md => key-performance-indicator-(KPI).md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/k/{key performance indicator (KPI).md => key-performance-indicator-(KPI).md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI).md b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/k/key performance indicator (KPI).md
rename to styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
From 4005aee1c2a52ac7cb320357651630babc0c909c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:49:11 -0600
Subject: [PATCH 319/486] Rename objectives and key results (OKR).md to
objectives-and-key-results-(OKR).md
---
...d key results (OKR).md => objectives-and-key-results-(OKR).md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/o/{objectives and key results (OKR).md => objectives-and-key-results-(OKR).md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md b/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/o/objectives and key results (OKR).md
rename to styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
From 0aa2c963ac91208195a89aede814e426039a4bf0 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 14:55:36 -0600
Subject: [PATCH 320/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index d4007ff2..5ab6ae2a 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -17,7 +17,9 @@ In some cases, however, identity-first language can be used, because some people
In all cases, don’t use language that has offensive or insensitive connotations, such as *maimed* or *impaired*.
The following table lists examples of people-first language (preferred), identity-first language (acceptable, context-dependent), and offensive or insensitive language (never allowed).
- **Preferred (people-first)** | **Acceptable (identity-first)** | **Do not use (offensive/insensitive)** |
+
+
+ | **Preferred (people-first)** | **Acceptable (identity-first)** | **Do not use (offensive/insensitive)** |
|----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| Person who is blind, person with low vision | Blind person | Sight-impaired, vision-impaired |
| Person who is deaf, person with a hearing disability | Deaf person | Hearing-impaired |
From 9caaee707dc7e0febbb8de12a3ff8a6fddbdf79e Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 15:11:00 -0600
Subject: [PATCH 321/486] Update key-performance-indicator-(KPI).md
---
.../k/key-performance-indicator-(KPI).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
index d196f343..900d2b42 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
+++ b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
@@ -16,4 +16,4 @@ On subsequent mentions on the same screen or pane, or in the same topic, article
In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** [key result (KR)](~), [objectives and key results (OKR)] (~)
+**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [objectives and key results (OKR)](a-z-word-list-term-collections/o/objectives-and-key-results-(OKR))
From b7f0e3c6708a23f5fe56fd7a2b9e111e9a8b8de7 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 15:12:11 -0600
Subject: [PATCH 322/486] Update key-result-(KR).MD
---
styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD b/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
index 5951aa5a..90218611 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
+++ b/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
@@ -14,4 +14,4 @@ Spell out on the first mention and include the abbreviation in parentheses immed
On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KR*.
-**See also** [key performance indicator (KPI)](~), [objectives and key results (OKR)] (~)
+**See also** [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI)), [objectives and key results (OKR)](a-z-word-list-term-collections/o/objectives-and-key-results-(OKR))
From 8f5a6c07cf6327cd5b7387009f8a607ae29235b3 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 15:12:53 -0600
Subject: [PATCH 323/486] Update objectives-and-key-results-(OKR).md
---
.../o/objectives-and-key-results-(OKR).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md b/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
index 0189e806..95e49794 100644
--- a/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
+++ b/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
@@ -16,4 +16,4 @@ On subsequent mentions on the same screen or pane, or in the same topic, article
In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** [key result (KR)](~), [key performance indicator (KPI)] (~)
+**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI))
From b17d90944752dd74865b3e552a15ff5fcc330f42 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 15:18:29 -0600
Subject: [PATCH 324/486] Update accessibility-terms.md
---
.../term-collections/accessibility-terms.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
index 5ab6ae2a..94270101 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/accessibility-terms.md
@@ -24,7 +24,7 @@ The following table lists examples of people-first language (preferred), identit
| Person who is blind, person with low vision | Blind person | Sight-impaired, vision-impaired |
| Person who is deaf, person with a hearing disability | Deaf person | Hearing-impaired |
| Person with limited mobility, person who has a mobility or physical disability | Physically disabled person, wheelchair user | Crippled, lame, handicapped |
-| Is unable to speak, uses sign language, uses synthetic speech* | | Dumb, mute, non-verbal |
+| Is unable to speak, uses sign language, uses synthetic speech | | Dumb, mute, non-verbal |
| Has multiple sclerosis, cerebral palsy, a seizure disorder, or muscular dystrophy | | Affected by, stricken with, suffers from, a victim of, an epileptic |
| Person without a disability | Non-disabled person, able-bodied person | Normal person, healthy person |
| Person with a prosthetic limb, person with a limb difference, person with an amputation | Amputee | Maimed, missing a limb, birth defect |
From 839b447b15e89f35c9cfc6a8a48971067aba2a8a Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 22 Feb 2023 15:30:51 -0600
Subject: [PATCH 325/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index f1694c9f..5fc8da47 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 02/12/2023
+ms.date: 02/22/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -15,6 +15,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
+| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)) | Created new topic.
+| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
+| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
| June 24, 2022 | [Date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
| June 24, 2022 | [Colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
From ff74cc43bf5450646d65df60e85e18db8f73b1f9 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Fri, 10 Mar 2023 09:19:36 -0600
Subject: [PATCH 326/486] Update tables.md
---
styleguide/scannable-content/tables.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/styleguide/scannable-content/tables.md b/styleguide/scannable-content/tables.md
index 82265598..7fa99d2f 100644
--- a/styleguide/scannable-content/tables.md
+++ b/styleguide/scannable-content/tables.md
@@ -3,7 +3,7 @@ title: Tables - Microsoft Style Guide
description: Discusses tables, which make complex information easier to understand by presenting it in a clear structure.
author: pallep
ms.author: pallep
-ms.date: 10/6/2018
+ms.date: 03/10/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -54,15 +54,15 @@ Balance row height by increasing the width of text-heavy columns and reducing th
## Header rows
If
-the first row of your table contains column headings, you have a header
+the first row of your table contains column headers, you have a header
row. Distinguish the text in the header row from the rest of the text
in the table. For example, make it larger, bolder, or a different color.
Column
-headers identify the data each column contains. Make headings precise for usability. For example, don't use "Name". Instead, make column headers specific as in "Group" or "Employee". (While screen readers use header information to identify rows and columns, specificity helps all users find the information they're looking for.)
+headers identify the data each column contains. Make headers precise for usability. For example, don't use "Name". Instead, make column headers specific as in "Group" or "Employee". (While screen readers use header information to identify rows and columns, specificity helps all users find the information they're looking for.)
Don’t
-organize a table so that the column heading forms a complete sentence
+organize a table so that the column header forms a complete sentence
when combined with the cell contents. This can make the table difficult
to localize.
@@ -77,7 +77,7 @@ Microsoft Word, select the header row. On the **Layout** tab under **Table Tools
Use
sentence-style capitalization for the table title and each column
-heading. Use sentence-style capitalization for the text in cells unless
+header. Use sentence-style capitalization for the text in cells unless
there’s a reason not to (for example, keywords that must be
lowercase).
@@ -85,7 +85,7 @@ lowercase).
If there’s text that introduces the table, it should be a complete sentence and end with a period, not a colon.
-Don’t use ellipses at the end of column headings.
+Don’t use ellipses at the end of column headers.
For
the text in cells, use periods or other end punctuation only if the
From 8c35c294cce4aee30ef21924b5a08a1bfce325c8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 11 Apr 2023 10:05:36 -0500
Subject: [PATCH 327/486] Update less-vs-fewer-vs-under.md
---
.../a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md b/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
index 3674bd44..c7ab7b1d 100644
--- a/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
+++ b/styleguide/a-z-word-list-term-collections/l/less-vs-fewer-vs-under.md
@@ -3,7 +3,7 @@ title: less vs. fewer vs. under - Microsoft Style Guide
description: Guidelines for using the terms less vs. fewer vs. under in Microsoft documents.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 04/11/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -17,7 +17,6 @@ When comparing quantities:
- Don't use *under* to refer to a quantity or number.
**Examples**
-Create an app in less than 5 minutes.
The new building has less floor space and contains fewer offices.
The new building has fewer square feet of floor space and contains fewer offices.
Fewer than 75 members were present.
From 20aa0cfc01bc93ab2b049c35bde3de249f4f5545 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 11:49:02 -0500
Subject: [PATCH 328/486] Delete illustrating-network-traffic-flows.md
---
.../illustrating-network-traffic-flows.md | 111 ------------------
1 file changed, 111 deletions(-)
delete mode 100644 styleguide/procedures-instructions/illustrating-network-traffic-flows.md
diff --git a/styleguide/procedures-instructions/illustrating-network-traffic-flows.md b/styleguide/procedures-instructions/illustrating-network-traffic-flows.md
deleted file mode 100644
index 7fd8ea37..00000000
--- a/styleguide/procedures-instructions/illustrating-network-traffic-flows.md
+++ /dev/null
@@ -1,111 +0,0 @@
----
-title: Illustrating network traffic flows - Microsoft Style Guide
-description: Describes how to illustrate network traffic flows and provides guidelines to follow and various examples of network flow descriptions.
-author: pallep
-ms.author: pallep
-ms.date: 01/19/2018
-ms.topic: article
-ms.prod: non-product-specific
----
-
-# Illustrating network traffic flows
-
-When
-you need to create a graphical representation of network traffic
-using industry or proprietary protocols, follow these guidelines.
-Always include a legend that explains the visual conventions.
-
-## Use colors carefully
-
-Use
-a consistent color, such as white, gray, or a light accent color,
-for important elements in the network diagram. Accentuate with
-additional colors. Text, graphics, and lines
-should contrast with the background to support people with limited
-vision.
-
-## Use consistent text formatting
-
-Use sentence-style capitalization. To learn more, see [Capitalization](~/capitalization.md).
-
-## Represent communication with arrows, lines, and labels
-
-**Use arrows to indicate which computer initiates communication.**
-Use a single-headed arrow to indicate a single initiator of
-communication. Use a double-headed arrow to indicate that the
-computer shown at either end of the arrow can initiate
-communication.
-
-With both types of arrows, subsequent communication is two-way.
-
-
-
-**Use line styles to distinguish different traffic flows.** Choose line colors that contrast with the image background
-and are distinct when printed or viewed in black and white.
-
-
-
-**Label specific network traffic.** If possible, overlay the label onto the line:
-
-
-
-Otherwise, add the label as a callout:
-
-
-
-## Represent security boundaries with solid vertical lines
-
-Use
-a solid vertical line to indicate a security boundary. Draw lines
-that indicate network traffic flow across the vertical line. This
-example shows firewalled and partitioned networks in Microsoft
-Azure.
-
-
-
-## Use standard network traffic syntax
-
-Use the following syntax to create the label for the network traffic flow:
-
-*SUBSUBPROT/SUBPROT/PROT/TCP SourceRange-\>DestRange,UDP SourceRange-\>DestRange*
-
-**SUBSUBPROT/SUBPROT/PROT** List
-the protocols using their standard industry acronym or name, from the
-highest in the protocol stack to the lowest. For example,
-XMPP/MTLS.
-
-**"/TCP," "/UDP," or "/TCP\&UDP"** Indicate
-whether the following ports are for TCP traffic, UDP traffic,
-or a combination of TCP and UDP traffic ("/TCP *SourceRange*-\>*DestRange*,UDP *SourceRange*-\>*DestRange"*). If
-both TCP and UDP use the same set of ports, use "/TCP\&UDP."
-You can omit "/TCP" if the traffic is known to be TCP traffic only.
-UDP traffic must be indicated with "/UDP *SourceRange*-\>*DestRange."*
-
-**SourceRange-\>DestRange** Use the *SourceRange* and *DestRange*
-values to indicate the source and destination ports for TCP or UDP
-traffic. There can be multiple sets of source and
-destination ranges. For four-digit and five-digit port numbers,
-omit the comma separating the thousands. For example, use "41239,"
-not "41,239." *SourceRange* and *DestRange*
-can be a single TCP or UDP port, a port range, multiple
-individual ports, multiple ranges, or a combination of individual
-ports and port ranges (each separated by a comma) in the order in
-which they’re used. You can omit port numbers if they're
-known. Use "dyn" to indicate dynamically allocated source ports
-(also known as "ephemeral ports"). Omit "dyn-\>" if the initiator
-uses only dynamic ports.
-
-
-| **Examples of explicitly stated protocols and source and destination ports** | **Examples that omit "/TCP," known ports, and dynamic source ports** |
-|------------------------------------------------------------------------------|----------------------------------------------------------------------|
-| HTTP/TCP dyn->80 | HTTP |
-| HTTP/TCP dyn->443 | HTTPS |
-| HTTP/TCP dyn->8080 | HTTP 8080 |
-| HTTP/TCP dyn->53 | DNS/TCP&UDP |
-| SRTP/TCP&UDP dyn->50000-59999 | SRTP/TCP&UDP 50000-59999 |
-| CIFS/TCP dyn->135,445 | CIFS 135,445 |
-| STUN/UDP dyn->3478 | STUN/UDP 3478 |
-| SIP/TLS/TCP dyn->444 | SIP 444 |
-| XMPP/MTLS/TCP dyn->23456 | XMPP/MTLS 23456 |
-| ABC/TCP 123->456 | ABC 123->456 |
-
From 3075ac1436e73b2bd7c2d0a194bd83c1b29ed0ba Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 11:53:26 -0500
Subject: [PATCH 329/486] Update date-time-terms.md
---
.../term-collections/date-time-terms.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
index 41e97bc8..5f1f3f0c 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/date-time-terms.md
@@ -3,7 +3,7 @@ title: Date and time terms - Microsoft Style Guide
description: Describes how to implement date and time terms and provides a table that outlines the usage for various date and time terms.
author: pallep
ms.author: pallep
-ms.date: 06/24/2022
+ms.date: 05/09/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -21,7 +21,7 @@ This section covers usage for terms related to time and date.
| **Days of the week: Sunday–Saturday** | Capitalize the days of the week. Don't use abbreviations unless space is extremely limited. Don't include a period with the abbreviations.
Three-letter abbreviations are preferred: *Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*
In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations: *Su, Mo, Tu, We, Th, Fr,* and *Sa* *S, M, T, W, T, F,* and *S*
For the three-letter and two-letter abbreviations, use sentence-style capitalization (*Su*), not all uppercase (*SU*). |
| **midnight, noon** | Use *noon* and *midnight*. Don't use *12:00 noon* and *12:00 midnight*.
Midnight is the beginning of the new day, not the end of the old one. |
| **Months: January–December** | Capitalize the names of months and their abbreviations.
Don't use abbreviations unless space is extremely limited. Use three-letter abbreviations when necessary: *Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* Don't include a period with the abbreviations. |
-| **Seasons: Fall, autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
+| **Seasons: autumn, winter, spring, summer** | Don't refer to seasons if you can avoid it. Talk about months or calendar quarters instead. If you must mention a specific season, identify the hemisphere, too. (Summer in the northern hemisphere is winter in the southern hemisphere.)
Don't capitalize the seasons except to designate an issue of a publication, such as *Spring 2017*. |
| **Time, ranges of time** | Use numerals for times of day: 2:00, 4:15, 7:30. Always include *AM* and *PM*.
Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend.
In text, use *to* in a range of times. **Example** 10:00 AM to 2:00 PM
In a schedule or listing, use an en dash with no spaces around it. **Example** 10:00 AM–2:00 PM
**Exception** In a date range that includes two times and two dates, add spaces around the en dash. Lead with whatever is most important to the customer within the context: time of day or date. **Examples** 2:15 AM–4:45 PM 4/1/16 (time range on a single day) 12/1/17 2:15 PM – 4/1/18 4:45 PM (time plus date range) |
| **Time zones: Eastern Time, Central Time, Mountain Time, Pacific Time, Coordinated Universal Time (UTC), Greenwich Mean Time (GMT)** | Capitalize time zones. Don't abbreviate unless space is severely limited. If you must abbreviate, use *ET, CT, MT,* and *PT*.
Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.
If you're referring to a time zone as a geographical area, call it a zone. **Example** in the Pacific Time zone
Not all time zones have names, and some time-zone names are used in more than one geographical area. If you're talking about a particular place, clarify the country or reference Coordinated Universal Time (UTC). Don't include spaces around the plus sign (+) or hyphen (-). **Examples** Eastern Time (UTC-5) Eastern Time (UTC+10) Eastern Time (Australia)
For time zones without names, refer to the offset from Coordinated Universal Time. **Example** UTC+7
Don't abbreviate *Coordinated Universal Time* in text unless space is severely limited. Use *UTC,* never *CUT*. (It's OK to use UTC in references to a specific time zone, such as *UTC+7*.) Don't use *Universal Time Coordinate or Universal Time Coordinated*.
Don't use *Greenwich Mean Time* or *GMT* by itself unless you have no other choice. Use *Coordinated Universal Time* instead. On the first mention, it's OK to refer to *Coordinated Universal Time (Greenwich Mean Time)*. |
From 1538c5ac107462ebd5e4b12dfdc874993c9beab9 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 12:27:23 -0500
Subject: [PATCH 330/486] Update key-performance-indicator-(KPI).md
---
.../k/key-performance-indicator-(KPI).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
index 900d2b42..df821de0 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
+++ b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
@@ -16,4 +16,4 @@ On subsequent mentions on the same screen or pane, or in the same topic, article
In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [objectives and key results (OKR)](a-z-word-list-term-collections/o/objectives-and-key-results-(OKR))
+**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))
From 8d89afe24868cb14663733483163036b56b3a58b Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 12:29:52 -0500
Subject: [PATCH 331/486] Update key-performance-indicator-(KPI).md
---
.../k/key-performance-indicator-(KPI).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
index df821de0..b5103432 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
+++ b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md
@@ -16,4 +16,4 @@ On subsequent mentions on the same screen or pane, or in the same topic, article
In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))
+**See also** [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(kr)), [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))
From 29d77357d20becb08a91f77f096366dbf2c9504c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 12:30:58 -0500
Subject: [PATCH 332/486] Update key-result-(KR).MD
---
styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD b/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
index 90218611..3f02cd79 100644
--- a/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
+++ b/styleguide/a-z-word-list-term-collections/k/key-result-(KR).MD
@@ -14,4 +14,4 @@ Spell out on the first mention and include the abbreviation in parentheses immed
On subsequent mentions on the same screen or pane, or in the same topic, article or flow, it’s OK to use the abbreviation *KR*.
-**See also** [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI)), [objectives and key results (OKR)](a-z-word-list-term-collections/o/objectives-and-key-results-(OKR))
+**See also** [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(kpi)), [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))
From c66e09b845773387e45941d269e57dd751a066df Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 12:31:40 -0500
Subject: [PATCH 333/486] Update objectives-and-key-results-(OKR).md
---
.../o/objectives-and-key-results-(OKR).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md b/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
index 95e49794..d4d9340e 100644
--- a/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
+++ b/styleguide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR).md
@@ -16,4 +16,4 @@ On subsequent mentions on the same screen or pane, or in the same topic, article
In UI, if the full term cannot be spelled out due to space constraints, it’s OK to abbreviate on the first mention. If possible, use the spelled out term somewhere else within the same flow for context.
-**See also** [key result (KR)](a-z-word-list-term-collections/k/key-result-(KR)), [key performance indicator (KPI)](a-z-word-list-term-collections/k/key-performance-indicator-(KPI))
+**See also** [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(kr)), [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(kpi))
From 8f83234903568d8d82268b09c99d3b26f78c3f3d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 13:17:52 -0500
Subject: [PATCH 334/486] Update top-10-tips-style-voice.md
---
styleguide/top-10-tips-style-voice.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/top-10-tips-style-voice.md b/styleguide/top-10-tips-style-voice.md
index b7883e80..665699f5 100644
--- a/styleguide/top-10-tips-style-voice.md
+++ b/styleguide/top-10-tips-style-voice.md
@@ -3,7 +3,7 @@ title: Top 10 tips for Microsoft style and voice - Microsoft Style Guide
description: Instructs to use bigger ideas, fewer words, write like you speak, project friendliness and get to the point fast.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 01/19/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -60,7 +60,7 @@ The Recommended Charts command on the Insert tab recommends charts that
are likely to represent your data well. Use the command when you want
to visually present data, and you're not sure how to do it.
-With this: Create a chart that's just right for your data by using the Recommend Charts command on the Insert tab.
+With this: Create a chart that's just right for your data by using the Recommended Charts command on the Insert tab.
## When in doubt, don’t capitalize
Default to sentence-style capitalization—capitalize only the first word of
From 244830574f4b003112639f5eeef9f11aaa9a7bf3 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 9 May 2023 13:22:39 -0500
Subject: [PATCH 335/486] Update emes.md
---
styleguide/punctuation/dashes-hyphens/emes.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/punctuation/dashes-hyphens/emes.md b/styleguide/punctuation/dashes-hyphens/emes.md
index f5ffa797..bced2660 100644
--- a/styleguide/punctuation/dashes-hyphens/emes.md
+++ b/styleguide/punctuation/dashes-hyphens/emes.md
@@ -1,9 +1,9 @@
---
title: Em dashes - Microsoft Style Guide
-description: Instructs to use an em dash (-) to set off a parenthetical phrase with more emphasis than parenthesis provide. Don't add spaces around a em dash.
+description: Instructs to use an em dash (-) to set off a parenthetical phrase with more emphasis than parenthesis provide. Don't add spaces around an em dash.
author: pallep
ms.author: pallep
-ms.date: 12/06/2022
+ms.date: 05/09/2023
ms.topic: article
ms.prod: non-product-specific
---
From e66249f9abb575e3913c80824104ea54e4d7d06e Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 09:37:17 -0500
Subject: [PATCH 336/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 5fc8da47..c7b04d2c 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,7 +16,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
-| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)) | Created new topic.
+| February 22, 2023 | [objectives and key results (OKR)]([https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
From 048be56e99f932d4237f229b49e53a05a8094fd4 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 09:37:41 -0500
Subject: [PATCH 337/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index c7b04d2c..b0a6c920 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,7 +16,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
-| February 22, 2023 | [objectives and key results (OKR)]([https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
+| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)(https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
From 3bac86ea75cce1ff65dff5668104bd96908e23a8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 09:38:47 -0500
Subject: [PATCH 338/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index b0a6c920..0fbca083 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,7 +16,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
-| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/bojectives-and-key-results-(OKR)(https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
+| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR)(https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
From 88602f026e57c9310c77a66283f01b8e9252ee17 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 09:39:32 -0500
Subject: [PATCH 339/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 0fbca083..c0710b54 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -16,7 +16,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
-| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(OKR)(https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr))) | Created new topic.
+| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr)) | Created new topic.
| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
From 405bf2e9dc98c190770d59f73e0039fc030fc7d4 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 13:59:18 -0500
Subject: [PATCH 340/486] Update keys-keyboard-shortcuts.md
---
.../term-collections/keys-keyboard-shortcuts.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
index f087495e..c2514f22 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
@@ -62,7 +62,7 @@ capitalization and spell it as it appears on the keyboard.
| **Control** | Capitalize. Use to refer to the *Control key* on the Mac keyboard. |
| **Ctrl** | Capitalize. Use to refer to the *Ctrl key*. Don’t use for the Mac keyboard. |
| **Del** | Capitalize. Use to refer to the *Del key*. On the Mac keyboard only, use to refer to the *forward delete key*. |
-| **Delete** | Capitalize. Use to refer to the *back delete key* on the Mac keyboard. |
+| **Delete** | Capitalize. Use to refer to the *delete key*. |
| **End** | Capitalize. Use to refer to the *End key*. |
| **Enter** | Capitalize. Use to refer to the *Enter key*. On the Mac, use only when functionality requires it. |
| **Esc** | Always use *Esc,* not *Escape*. |
From 71678f3260fca23dde48c8f241a1b798c7d84a7d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 10 May 2023 13:59:47 -0500
Subject: [PATCH 341/486] Update keys-keyboard-shortcuts.md
---
.../term-collections/keys-keyboard-shortcuts.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
index c2514f22..82c42a9e 100644
--- a/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
+++ b/styleguide/a-z-word-list-term-collections/term-collections/keys-keyboard-shortcuts.md
@@ -3,7 +3,7 @@ title: Keys and keyboard shortcuts - Microsoft Style Guide
description: Describes how to refer to keys and keyboard shortcuts in Microsoft content and provides a list that outlines usage for various keyboard actions and access.
author: pallep
ms.author: pallep
-ms.date: 12/13/2022
+ms.date: 05/10/2023
ms.topic: article
ms.prod: non-product-specific
---
From 415b75fec6d323ed3967b135162b5fe4a7d4220d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:31:47 -0500
Subject: [PATCH 342/486] Update disable-disabled.md
---
.../d/disable-disabled.md | 17 +++++++++--------
1 file changed, 9 insertions(+), 8 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index 7dc75bff..d01a2416 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -1,27 +1,28 @@
---
-title: disable, disabled - Microsoft Style Guide
-description: Describes guidelines to use 'disable' or 'disabled' in Microsoft documents, including instances where this word is appropriate or allowed.
+title: disable, disables (functionality) - Microsoft Style Guide
+description: Describes guidelines to use 'disable' or 'disables' in Microsoft documents, including instances where this word is appropriate or allowed.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 05/22/2023
ms.topic: article
ms.prod: non-product-specific
---
# disable, disabled
-Don't use *disabled* to refer to people with disabilities.
+Don’t use *disable* to describe making a command or function inactive or unavailable. Replace with specific, plain language phrases, such as *turn off*, *hide*, *make unavailable*, *make inactive*, *block*, or *remove*, as appropriate.
-In content for a technical audience, it's OK to use *disable* to mean making a command or function inactive and *disabled* to describe such commands and functions.
+As a state, replace *disabled* with descriptors such as *inactive*, *unavailable*, or *off*.
-In other content, use *turned off* or *isn’t available.*
+When admins turn off products, settings, or features, it’s OK to use *disable*. But substitute terms like *make unavailable* or *block* if you can reasonably do so.
-**Examples**
+**Example**
If the command prompt isn’t available, your network administrator might have turned off this feature.
-Disable the command prompt to prevent users from opening a command window.
**See also**
[Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
+
+[disabled (person)]
From a8fd4a6d811770c0fd227c87e9ed15b67e9a6414 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:35:11 -0500
Subject: [PATCH 343/486] Create disabled (person).md
---
.../a-z-word-list-term-collections/d/disabled (person).md | 5 +++++
1 file changed, 5 insertions(+)
create mode 100644 styleguide/a-z-word-list-term-collections/d/disabled (person).md
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled (person).md b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
new file mode 100644
index 00000000..d4d8de97
--- /dev/null
+++ b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
@@ -0,0 +1,5 @@
+Don’t use *disabled* to refer to people with disabilities, unless you know that a specific audience prefers otherwise. Use *person with a disability* or a more specific, people-first term like *person with low vision*.
+
+For more details on exceptions to this guideline, see Accessibility terms [https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms].
+
+**See also** Accessibility guidelines and requirements [https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements]
From 1c823adf6141d29d45f1718a6c9cd96c03aa10c8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:36:24 -0500
Subject: [PATCH 344/486] Update disabled (person).md
---
.../d/disabled (person).md | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled (person).md b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
index d4d8de97..4e423e44 100644
--- a/styleguide/a-z-word-list-term-collections/d/disabled (person).md
+++ b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
@@ -1,3 +1,15 @@
+---
+title: disabled (person) - Microsoft Style Guide
+description: Describes guidelines to use 'disabled' in Microsoft documents, including instances where this word is appropriate or allowed.
+author: pallep
+ms.author: pallep
+ms.date: 05/22/2023
+ms.topic: article
+ms.prod: non-product-specific
+---
+
+# disabled (person)
+
Don’t use *disabled* to refer to people with disabilities, unless you know that a specific audience prefers otherwise. Use *person with a disability* or a more specific, people-first term like *person with low vision*.
For more details on exceptions to this guideline, see Accessibility terms [https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms].
From 5b75ad6cabb520c8d85adc8c2a15738f03a8d836 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:37:37 -0500
Subject: [PATCH 345/486] Update disabled (person).md
---
.../a-z-word-list-term-collections/d/disabled (person).md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled (person).md b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
index 4e423e44..d7a44542 100644
--- a/styleguide/a-z-word-list-term-collections/d/disabled (person).md
+++ b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
@@ -12,6 +12,6 @@ ms.prod: non-product-specific
Don’t use *disabled* to refer to people with disabilities, unless you know that a specific audience prefers otherwise. Use *person with a disability* or a more specific, people-first term like *person with low vision*.
-For more details on exceptions to this guideline, see Accessibility terms [https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms].
+For more details on exceptions to this guideline, see [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
-**See also** Accessibility guidelines and requirements [https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements]
+**See also** [Accessibility guidelines and requirements] (~/accessibility/accessibility-guidelines-requirements.md)
From f8739e31f948de04a223e4eedad4b70aed9a8ccb Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:39:50 -0500
Subject: [PATCH 346/486] Update disabled (person).md
---
.../a-z-word-list-term-collections/d/disabled (person).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled (person).md b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
index d7a44542..294194b0 100644
--- a/styleguide/a-z-word-list-term-collections/d/disabled (person).md
+++ b/styleguide/a-z-word-list-term-collections/d/disabled (person).md
@@ -14,4 +14,4 @@ Don’t use *disabled* to refer to people with disabilities, unless you know t
For more details on exceptions to this guideline, see [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
-**See also** [Accessibility guidelines and requirements] (~/accessibility/accessibility-guidelines-requirements.md)
+**See also** [Accessibility guidelines and requirements](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/accessibility/accessibility-guidelines-requirements.md)
From 294193d0ee6934d6027afef806b8baafbd8bf0a8 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:51:35 -0500
Subject: [PATCH 347/486] Update TOC.md
---
styleguide/TOC.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 795eec9b..af2d3d30 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -224,7 +224,8 @@
### [dimmed](a-z-word-list-term-collections/d/dimmed.md)
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
-### [disable, disabled](a-z-word-list-term-collections/d/disable-disabled.md)
+### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
+### [disabled (person)](~/a-z-word-list-term-collections/d/disabled (person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From 03906908ff05876ac75a0591723de0c4cf6498ed Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:52:38 -0500
Subject: [PATCH 348/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index af2d3d30..d6a881b2 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](~/a-z-word-list-term-collections/d/disabled (person).md)
+### [disabled (person)](/a-z-word-list-term-collections/d/disabled (person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From 8df609c0d5ba07d5c22bc8a4333a90f442443af4 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:53:21 -0500
Subject: [PATCH 349/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index d6a881b2..607fc7ec 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](/a-z-word-list-term-collections/d/disabled (person).md)
+### [disabled (person)](/a-z-word-list-term-collections/d/disabled(person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From 532d8f239fa72a4e0df294e6b67e3d069d57fb3e Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:56:55 -0500
Subject: [PATCH 350/486] Rename disabled (person).md to disabled(person).md
---
.../d/{disabled (person).md => disabled(person).md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/d/{disabled (person).md => disabled(person).md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled (person).md b/styleguide/a-z-word-list-term-collections/d/disabled(person).md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/d/disabled (person).md
rename to styleguide/a-z-word-list-term-collections/d/disabled(person).md
From 558787e51114091bc254942aec1a1ca61454a2cb Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 09:57:31 -0500
Subject: [PATCH 351/486] Rename disabled(person).md to disabled-(person).md
---
.../d/{disabled(person).md => disabled-(person).md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename styleguide/a-z-word-list-term-collections/d/{disabled(person).md => disabled-(person).md} (100%)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled(person).md b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
similarity index 100%
rename from styleguide/a-z-word-list-term-collections/d/disabled(person).md
rename to styleguide/a-z-word-list-term-collections/d/disabled-(person).md
From 2e6dd4afa9ac643ed40b471ccbc84c6161db565d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:02:07 -0500
Subject: [PATCH 352/486] Update disable-disabled.md
---
.../a-z-word-list-term-collections/d/disable-disabled.md | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index d01a2416..fd63fb92 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -24,5 +24,4 @@ If the command prompt isn’t available, your network administrator might have t
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
-
-[disabled (person)]
+[disabled (person)] (~/a-z-word-list-term-collections/d/disabled-(person).md)
From 7ab60287a5ff05f22eec84d867849dac9a976180 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:02:33 -0500
Subject: [PATCH 353/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 607fc7ec..fc2dcbe9 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](/a-z-word-list-term-collections/d/disabled(person).md)
+### [disabled (person)](/a-z-word-list-term-collections/d/disabled-(person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From df8bbf5e5ef7c8c866560c90869a5b1b333f1088 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:21:05 -0500
Subject: [PATCH 354/486] Update disable-disabled.md
---
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index fd63fb92..7c32870f 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -24,4 +24,4 @@ If the command prompt isn’t available, your network administrator might have t
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
-[disabled (person)] (~/a-z-word-list-term-collections/d/disabled-(person).md)
+[disabled (person)] (styleguide/a-z-word-list-term-collections/d/disabled-(person).md)
From f9ec5f79bb89bc9718656e0c1ce4e85c0353356b Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:21:41 -0500
Subject: [PATCH 355/486] Update disable-disabled.md
---
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index 7c32870f..fd63fb92 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -24,4 +24,4 @@ If the command prompt isn’t available, your network administrator might have t
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
-[disabled (person)] (styleguide/a-z-word-list-term-collections/d/disabled-(person).md)
+[disabled (person)] (~/a-z-word-list-term-collections/d/disabled-(person).md)
From 0643ed1ca6e91643ad97442ad4a253ee3528bdce Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:21:53 -0500
Subject: [PATCH 356/486] Update disable-disabled.md
---
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index fd63fb92..4f3d638c 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -24,4 +24,4 @@ If the command prompt isn’t available, your network administrator might have t
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
-[disabled (person)] (~/a-z-word-list-term-collections/d/disabled-(person).md)
+[disabled (person)](~/a-z-word-list-term-collections/d/disabled-(person).md)
From 341c526535b42e03ce1ec099f7e41621fe915844 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:22:03 -0500
Subject: [PATCH 357/486] Update disable-disabled.md
---
styleguide/a-z-word-list-term-collections/d/disable-disabled.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index 4f3d638c..87964257 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -24,4 +24,5 @@ If the command prompt isn’t available, your network administrator might have t
[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
+
[disabled (person)](~/a-z-word-list-term-collections/d/disabled-(person).md)
From 1ce5b7741604e987c0a00b77809b785aaf785755 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:24:08 -0500
Subject: [PATCH 358/486] Update disable-disabled.md
---
.../d/disable-disabled.md | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
index 87964257..b2df069a 100644
--- a/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
+++ b/styleguide/a-z-word-list-term-collections/d/disable-disabled.md
@@ -20,9 +20,10 @@ When admins turn off products, settings, or features, it’s OK to use *disable*
If the command prompt isn’t available, your network administrator might have turned off this feature.
**See also**
-[Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
-[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
-[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
-[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
+[Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
+[turn on, turn off](~/a-z-word-list-term-collections/t/turn-on-turn-off.md)
+[disabled (person)](~/a-z-word-list-term-collections/d/disabled-(person).md)
+[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
+[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
+
-[disabled (person)](~/a-z-word-list-term-collections/d/disabled-(person).md)
From 3956932dbb1532305f0b8cdf4ae94402c35f1781 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:31:55 -0500
Subject: [PATCH 359/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index fc2dcbe9..3a552980 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](/a-z-word-list-term-collections/d/disabled-(person).md)
+### [disabled (person)](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/a-z-word-list-term-collections/d/disabled-(person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From a512308570d4381d47b92e9ba2beceafd0cd903b Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:41:14 -0500
Subject: [PATCH 360/486] Update TOC.md
---
styleguide/TOC.md | 1 -
1 file changed, 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 3a552980..2402f6bd 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -944,7 +944,6 @@
## [Describing interactions with UI](procedures-instructions/describing-interactions-with-ui.md)
## [Describing alternative input methods](procedures-instructions/describing-alternative-input-methods.md)
## [Formatting text in instructions](procedures-instructions/formatting-text-in-instructions.md)
-## [Illustrating network traffic flows](procedures-instructions/illustrating-network-traffic-flows.md)
# [Punctuation](punctuation/index.md)
## [Formatting punctuation](punctuation/formatting-punctuation.md)
## [Apostrophes](punctuation/apostrophes.md)
From ffaacdd9cea88f2acab61da2682b404d69705e2e Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:45:32 -0500
Subject: [PATCH 361/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 2402f6bd..2908d185 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/a-z-word-list-term-collections/d/disabled-(person).md)
+### [disabled (person)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disabled-(person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From d43b9c9b25a732ca1f0774dd78f9b4d57d767360 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:50:48 -0500
Subject: [PATCH 362/486] Update disabled-(person).md
---
.../a-z-word-list-term-collections/d/disabled-(person).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled-(person).md b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
index 294194b0..487f3513 100644
--- a/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
+++ b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
@@ -14,4 +14,4 @@ Don’t use *disabled* to refer to people with disabilities, unless you know t
For more details on exceptions to this guideline, see [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
-**See also** [Accessibility guidelines and requirements](https://github.com/MicrosoftDocs/microsoft-style-guide-pr/blob/main/styleguide/accessibility/accessibility-guidelines-requirements.md)
+**See also** [Accessibility guidelines and requirements](https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements.md)
From 0e190cadcceb8cedbe3077ebc22c85d121e50f2f Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:51:10 -0500
Subject: [PATCH 363/486] Update disabled-(person).md
---
.../a-z-word-list-term-collections/d/disabled-(person).md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disabled-(person).md b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
index 487f3513..51ee7a74 100644
--- a/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
+++ b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md
@@ -14,4 +14,4 @@ Don’t use *disabled* to refer to people with disabilities, unless you know t
For more details on exceptions to this guideline, see [Accessibility term collection](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md)
-**See also** [Accessibility guidelines and requirements](https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements.md)
+**See also** [Accessibility guidelines and requirements](https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements)
From f2735b1e72337fb4e5664e834a7e073988b0f494 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 10:58:18 -0500
Subject: [PATCH 364/486] Update turn-on-turn-off.md
---
.../t/turn-on-turn-off.md | 13 ++++++-------
1 file changed, 6 insertions(+), 7 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
index aa8a1921..4fb5e4e2 100644
--- a/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
+++ b/styleguide/a-z-word-list-term-collections/t/turn-on-turn-off.md
@@ -3,7 +3,7 @@ title: turn on, turn off - Microsoft Style Guide
description: Describes how to use turn on and turn off as terminology in Microsoft articles and provides examples of using these terms in content.
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 05/22/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -12,19 +12,18 @@ ms.prod: non-product-specific
Use instead of *power on/power off, start/stop,* or *switch on/switch off* to mean turning the device on and off.
-Don't use to refer to selecting or clearing checkboxes in instructions. Use *select* and *clear* instead. It's OK to use *turn on/turn off* to refer to webpage options and toggles.
+Use instead of *enable* and *disable* to refer to commands and features that can be activated or deactivated. Or use more specific pairs of words such as *make available* and *make unavailable*; *show* and *hide*; *add* and *remove*; or *allow* and *block*.
-Use *turned on* and *turned off* instead of *enabled* and *disabled* to refer to commands and features that can be hidden or deactivated.
+Don't use to refer to selecting or clearing checkboxes in instructions. Use *select* and *clear* instead. It's OK to use *turn on/turn off* to refer to webpage options and toggles.
**Examples**
-To turn on your device ….
-To turn off pop-up blocking ….
-To keep all applied filters, turn on the **Pass all filters** toggle.
+To turn on pop-up blocking ….
+To keep all applied filters, turn on the **pass all filters** toggle.
If the command prompt isn’t available, your network administrator might have turned off this feature.
**See also**
[Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md)
-[disable, disabled](~/a-z-word-list-term-collections/d/disable-disabled.md)
+[disable, disables (functionality)](~/a-z-word-list-term-collections/d/disable-disabled.md)
[enable, enables](~/a-z-word-list-term-collections/e/enable-enables.md)
[shut down, shutdown](~/a-z-word-list-term-collections/s/shut-down-shutdown.md)
[unavailable](~/a-z-word-list-term-collections/u/unavailable.md)
From f4050f217070e4c75fdae779ff8dd4cd45759a54 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 11:04:57 -0500
Subject: [PATCH 365/486] Update TOC.md
---
styleguide/TOC.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/TOC.md b/styleguide/TOC.md
index 2908d185..0937dc78 100644
--- a/styleguide/TOC.md
+++ b/styleguide/TOC.md
@@ -225,7 +225,7 @@
### [direction keys](a-z-word-list-term-collections/d/direction-keys.md)
### [directory](a-z-word-list-term-collections/d/directory.md)
### [disable, disables (functionality)](a-z-word-list-term-collections/d/disable-disabled.md)
-### [disabled (person)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disabled-(person).md)
+### [disabled (person)](a-z-word-list-term-collections/d/disabled-(person).md)
### [disc](a-z-word-list-term-collections/d/disc.md)
### [disjoint selection](a-z-word-list-term-collections/d/disjoint-selection.md)
### [disk](a-z-word-list-term-collections/d/disk.md)
From 899143b3635c2df15fdf841671a47fea8f337a64 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 22 May 2023 11:13:34 -0500
Subject: [PATCH 366/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index c0710b54..d217d0d7 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 02/22/2023
+ms.date: 05/22/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -15,7 +15,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
+| May 22, 2023 | [disable, disables (functionality)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disable-disabled) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to suggest alternatives for functionality. Provided an exception for admin use cases.
+| May 22, 2023 | [disabled (person)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disabled-(person)) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to reflect people-first language is preferred, but not always required if context is provided.
+| May 22, 2023 | [turn on, turn off](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/turn-on-turn-off) | Updated guidance to suggest as a replacement for enable, disable.
+ February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr)) | Created new topic.
| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
From 6583339de0d2a7c4830bd7c5df6d4e1325d6ed8d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:06:48 -0500
Subject: [PATCH 367/486] Update bluetooth.md
---
styleguide/a-z-word-list-term-collections/b/bluetooth.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/b/bluetooth.md b/styleguide/a-z-word-list-term-collections/b/bluetooth.md
index ea6b1341..8cca0c35 100644
--- a/styleguide/a-z-word-list-term-collections/b/bluetooth.md
+++ b/styleguide/a-z-word-list-term-collections/b/bluetooth.md
@@ -3,11 +3,11 @@ title: Bluetooth - Microsoft Style Guide
description: This article outlines use of the name Bluetooth per Microsoft style guidelines.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 06/06/2023
ms.topic: article
ms.prod: non-product-specific
---
# Bluetooth
-Bluetooth is a proper noun and a registered trademark. Always capitalize. Don’t include the registered trademark symbol (®).
+Bluetooth is a proper noun and a registered trademark. Always capitalize. Use the registered trademark symbol (®) upon first mention.
From 71139a745aa3127d3ad27cec4b9cfaef20635070 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:09:03 -0500
Subject: [PATCH 368/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index d217d0d7..d4560940 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 05/22/2023
+ms.date: 06/06/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -15,6 +15,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| June 6, 2023 | [Bluetooth](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/Bluetooth) | Updated guidance to use registered trademark symbol on first mention.
| May 22, 2023 | [disable, disables (functionality)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disable-disabled) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to suggest alternatives for functionality. Provided an exception for admin use cases.
| May 22, 2023 | [disabled (person)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disabled-(person)) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to reflect people-first language is preferred, but not always required if context is provided.
| May 22, 2023 | [turn on, turn off](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/turn-on-turn-off) | Updated guidance to suggest as a replacement for enable, disable.
From 134feeca65ae668dd2fe9606d5ca243dcffdf069 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:20:37 -0500
Subject: [PATCH 369/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 102 ++++++++++++++++----------------
1 file changed, 51 insertions(+), 51 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index d4560940..1eb0a051 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -15,57 +15,57 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| June 6, 2023 | [Bluetooth](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/Bluetooth) | Updated guidance to use registered trademark symbol on first mention.
-| May 22, 2023 | [disable, disables (functionality)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disable-disabled) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to suggest alternatives for functionality. Provided an exception for admin use cases.
-| May 22, 2023 | [disabled (person)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disabled-(person)) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to reflect people-first language is preferred, but not always required if context is provided.
-| May 22, 2023 | [turn on, turn off](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/turn-on-turn-off) | Updated guidance to suggest as a replacement for enable, disable.
- February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
-| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr)) | Created new topic.
-| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
-| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
-| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
-| June 24, 2022 | [Date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
-| June 24, 2022 | [Nouns and pronouns](https://learn.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
-| June 24, 2022 | [Person](https://learn.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
-| May 13, 2022 | [Lists](https://learn.microsoft.com/en-us/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples to address gaps in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
-| May 13, 2022 | [Periods](https://learn.microsoft.com/en-us/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
-| May 13, 2022 | [Numbers](https://learn.microsoft.com/en-us/style-guide/numbers) | Added new section on phone numbers.
-| May 13, 2022 | [phone, phone number](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
-| December 15, 2021 | [Cloud-computing terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
-| December 9, 2021 | [SQL, SQL server](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
-| August 26, 2021 | [multi-](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
-| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
-| August 25, 2021 | [Bias-free communication](https://learn.microsoft.com/en-us/style-guide/bias-free-communication) | Added inclusive language section.
-| August 12, 2021 | [colons](https://learn.microsoft.com/en-us/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
-| August 11, 2021 | [numbers](https://learn.microsoft.com/en-us/style-guide/numbers) | Replaced colons with ratio symbols.
-| August 10, 2021 | [date and time terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
-| May 31, 2021 | [workstream](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/w/workstream) | New guidance on spelling and use.
-| May 31, 2021 | [wellbeing](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/w/wellbeing) | New guidance on spelling and use.
-| April 30, 2021 | [invite](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/i/invite) | New topic.
-| April 30, 2021 | [dark mode](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dark-mode) | New topic.
-| April 30, 2021 | [SMB](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/smb) | New topic.
-| March 31, 2021 | [bits and bytes](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/bits-bytes-terms) | Updated guidance on when to abbreviate certain terms.
-| March 31, 2021 | [dialog box, dialog, dialogue](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue) | Updated guidance on use.
-| March 29, 2021 | [check, checkbox, check mark](~/a-z-word-list-term-collections/c/check-checkbox-check-mark.md) | Updated guidance on use.
-| March 26, 2021 | [dropdown](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/dropdown) | Updated guidance on spelling and use.
-| March 16, 2021 | [Welcome page](https://learn.microsoft.com/en-us/style-guide/welcome/) | Updated Welcome page.
-| January 15, 2021 | [blacklist](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/b/blacklist) | Updated guidance on spacing for alternative term, *blocklist*.
-| January 15, 2021 | [environment variable](~/a-z-word-list-term-collections/e/environment-variable.md) | Updated topic guidance.
-| January 15, 2021 | [whitelist](~/a-z-word-list-term-collections/w/whitelist.md) | Updated guidance on spacing for alternative term, *allowlist*.
-| November 24, 2020 | [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md) | Updated topic to include guidance on using words such as "see", "read", and "look".
-| November 24, 2020 | [global](~/a-z-word-list-term-collections/g/global.md) | Updated guidance wording to be more clear.
-| November 24, 2020 | [URLs and web addresses](~/urls-web-addresses.md) | Updated example in **References to specific sites and domains** section.
-| November 24, 2020 | [worldwide vs. international](~/a-z-word-list-term-collections/w/worldwide-vs-international.md) | Updated topic's wording and added example.
-| August 4, 2020 | [Bias-free communication](~/bias-free-communication.md) | Updated guidance regarding unconcsious racial bias and associated examples.
-| August 4, 2020 | [blacklist](~/a-z-word-list-term-collections/b/blacklist.md) | Updated guidance regarding usage and examples.
-| August 4, 2020 | [master/slave, master/subordinate](~/a-z-word-list-term-collections/m/master-slave.md) | Updated topic name, guidance, and examples.
-| August 4, 2020 | [whitelist](~/a-z-word-list-term-collections/w/whitelist.md) | Updated guidance regarding usage and examples.
-| June 30, 2020 | [above](~/a-z-word-list-term-collections/a/above.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [below](~/a-z-word-list-term-collections/b/below.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [destination](~/a-z-word-list-term-collections/d/destination.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [earlier](~/a-z-word-list-term-collections/e/earlier.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [Formatting punctuation](~/punctuation/formatting-punctuation.md) | Updated guidance by replacing *hyperlink* with *link*.
+| June 6, 2023 | [Bluetooth](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/b/Bluetooth) | Updated guidance to use registered trademark symbol on first mention.
+| May 22, 2023 | [disable, disables (functionality)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/disable-disabled) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to suggest alternatives for functionality. Provided an exception for admin use cases.
+| May 22, 2023 | [disabled (person)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/disabled-(person)) | Changed topic title to separate out functionality from accessibility meaning. Updated guidance to reflect people-first language is preferred, but not always required if context is provided.
+| May 22, 2023 | [turn on, turn off](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/turn-on-turn-off) | Updated guidance to suggest as a replacement for enable, disable.
+ February 22, 2023 | [Accessibility terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance to align with Accessibility (nuanced discussion of identity-first language); created new table of examples; adopted new table formatting for screen-reader compatibility.
+| February 22, 2023 | [objectives and key results (OKR)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/o/objectives-and-key-results-(okr)) | Created new topic.
+| February 22, 2023 | [key result (KR)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/k/key-result-(KR)) | Created new topic.
+| February 22, 2023 | [key performance indicator (KPI)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI)) | Created new topic.
+| October 18, 2022 | [Formatting text in instructions](https://learn.microsoft.com/style-guide/procedures-instructions/formatting-text-in-instructions) | Clarified the guidance on using *dialog*.
+| June 24, 2022 | [Date and time terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Colons](https://learn.microsoft.com/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time).
+| June 24, 2022 | [Nouns and pronouns](https://learn.microsoft.com/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI.
+| June 24, 2022 | [Person](https://learn.microsoft.com/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content.
+| May 13, 2022 | [Lists](https://learn.microsoft.com/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples to address gaps in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences.
+| May 13, 2022 | [Periods](https://learn.microsoft.com/style-guide/punctuation/periods) | Added link to Lists topic in guidance.
+| May 13, 2022 | [Numbers](https://learn.microsoft.com/style-guide/numbers) | Added new section on phone numbers.
+| May 13, 2022 | [phone, phone number](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/phone) | Changed title of topic to include "phone number." Revised guidance to include mobile phones and to address phone number formatting.
+| December 15, 2021 | [Cloud-computing terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/cloud-computing-terms) | Revised guidance to terms in the cloud-computing collection.
+| December 9, 2021 | [SQL, SQL server](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/sql-sql-server) | Revised guidance to use the article "a" with SQL and updated examples.
+| August 26, 2021 | [multi-](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/multi) | Added multicloud exception to guideline.
+| August 26, 2021 | [touch-sensitive](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/touch-sensitive) | Added new topic.
+| August 25, 2021 | [Bias-free communication](https://learn.microsoft.com/style-guide/bias-free-communication) | Added inclusive language section.
+| August 12, 2021 | [colons](https://learn.microsoft.com/style-guide/punctuation/colons) | Updated guidance on use of colons in clock time.
+| August 11, 2021 | [numbers](https://learn.microsoft.com/style-guide/numbers) | Replaced colons with ratio symbols.
+| August 10, 2021 | [date and time terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | New section on clock time.
+| May 31, 2021 | [workstream](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/w/workstream) | New guidance on spelling and use.
+| May 31, 2021 | [wellbeing](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/w/wellbeing) | New guidance on spelling and use.
+| April 30, 2021 | [invite](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/i/invite) | New topic.
+| April 30, 2021 | [dark mode](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/dark-mode) | New topic.
+| April 30, 2021 | [SMB](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/smb) | New topic.
+| March 31, 2021 | [bits and bytes](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/bits-bytes-terms) | Updated guidance on when to abbreviate certain terms.
+| March 31, 2021 | [dialog box, dialog, dialogue](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/dialog-box-dialog-dialogue) | Updated guidance on use.
+| March 29, 2021 | [check, checkbox, check mark](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/c/check-checkbox-check-mark) | Updated guidance on use.
+| March 26, 2021 | [dropdown](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/dropdown) | Updated guidance on spelling and use.
+| March 16, 2021 | [Welcome page](https://learn.microsoft.com/style-guide/welcome/) | Updated Welcome page.
+| January 15, 2021 | [blacklist](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/b/blacklist) | Updated guidance on spacing for alternative term, *blocklist*.
+| January 15, 2021 | [environment variable](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/environment-variable) | Updated topic guidance.
+| January 15, 2021 | [whitelist](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/w/whitelist) | Updated guidance on spacing for alternative term, *allowlist*.
+| November 24, 2020 | [Accessibility terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated topic to include guidance on using words such as "see", "read", and "look".
+| November 24, 2020 | [global](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/g/global) | Updated guidance wording to be more clear.
+| November 24, 2020 | [URLs and web addresses](https://learn.microsoft.com/style-guide/urls-web-addresses) | Updated example in **References to specific sites and domains** section.
+| November 24, 2020 | [worldwide vs. international](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/w/worldwide-vs-international) | Updated topic's wording and added example.
+| August 4, 2020 | [Bias-free communication](https://learn.microsoft.com/style-guide/bias-free-communication) | Updated guidance regarding unconcsious racial bias and associated examples.
+| August 4, 2020 | [blacklist](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/b/blacklist) | Updated guidance regarding usage and examples.
+| August 4, 2020 | [master/slave, master/subordinate](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/master-slave) | Updated topic name, guidance, and examples.
+| August 4, 2020 | [whitelist](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/w/whitelist) | Updated guidance regarding usage and examples.
+| June 30, 2020 | [above](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/a/above) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [below](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/b/below) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [destination](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/destination) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [earlier](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/earlier) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [Formatting punctuation](https://learn.microsoft.com/style-guide/punctuation/formatting-punctuation) | Updated guidance by replacing *hyperlink* with *link*.
| June 30, 2020 | [hot link](~/a-z-word-list-term-collections/h/hot-link.md) | Updated guidance by replacing *hyperlink* with *link*.
| June 30, 2020 | [hot spot, hotspot](~/a-z-word-list-term-collections/h/hot-spot-hotspot.md) | Updated guidance by replacing *hyperlink* with *link*.
| June 30, 2020 | [jump](~/a-z-word-list-term-collections/j/jump.md) | Updated guidance by replacing *hyperlink* with *link*.
From 9c123dd1e6d3af1a1a38fed47d0883cca069bc67 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:32:12 -0500
Subject: [PATCH 370/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 44 ++++++++++++++++-----------------
1 file changed, 22 insertions(+), 22 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 1eb0a051..57d50b72 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -66,28 +66,28 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| June 30, 2020 | [destination](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/destination) | Updated guidance by replacing *hyperlink* with *link*.
| June 30, 2020 | [earlier](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/earlier) | Updated guidance by replacing *hyperlink* with *link*.
| June 30, 2020 | [Formatting punctuation](https://learn.microsoft.com/style-guide/punctuation/formatting-punctuation) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [hot link](~/a-z-word-list-term-collections/h/hot-link.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [hot spot, hotspot](~/a-z-word-list-term-collections/h/hot-spot-hotspot.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [jump](~/a-z-word-list-term-collections/j/jump.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [later](~/a-z-word-list-term-collections/l/later.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [navigate](~/a-z-word-list-term-collections/n/navigate.md) | Updated guidance by replacing *hyperlink* with *link*.
-| June 30, 2020 | [shortcut, shortcut menu](~/a-z-word-list-term-collections/s/shortcut-shortcut-menu.md) | Updated guidance by replacing *hyperlink* with *link*.
-| April 29, 2020 | [Describing alternative input methods](~/procedures-instructions/describing-alternative-input-methods.md) | Updated example.
-| April 29, 2020 | [either/or](~/a-z-word-list-term-collections/e/either-or.md) | Updated example.
-| April 29, 2020 | [Formatting text instructions](~/procedures-instructions/formatting-text-in-instructions.md) | Revised table. Clarified wording for *Dialogue boxes* entry.
-| April 29, 2020 | [mixed reality, mixed-reality](~/a-z-word-list-term-collections/m/mixed-reality.md) | Updated topic; removed acronym guidelines.
-| April 29, 2020 | [pane](~/a-z-word-list-term-collections/p/pane.md) | Added guidelines regarding preposition use; "Use the preposition *on* when referring to the contents of a pane."
-| March 31, 2020 | [Capitalization](~/capitalization.md) | Added guidance for hyphenated compound words |
-| March 31, 2020 | [Hyphens](~/punctuation/dashes-hyphens/hyphens.md) | Updated list of examples. |
-| March 31, 2020 | [Later](~/a-z-word-list-term-collections/l/later.md) | Updated list of examples. |
-| March 31, 2020 | [Multifactor authentication](~/a-z-word-list-term-collections/m/multifactor-authentication.md) | Added guidance for *multifactor authentication*. |
-| March 31, 2020 | [Nouns and pronouns](~/grammar/nouns-pronouns.md) | Added guidance for *they*. |
-| March 31, 2020 | [Numbers](~/numbers.md) | Updated guidance on comma usage. |
-| March 31, 2020 | [runs vs. runs on](~/a-z-word-list-term-collections/r/runs-vs-runs-on.md) | Updated list of examples. |
-| March 31, 2020 | [Units of measure terms](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) | Updated examples on Speed frequency. Also updated comma exceptions and examples. |
-| September 21, 2019 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Added guidance for *scroll.* |
-| September 21, 2019 | [Start button, Start menu](~/a-z-word-list-term-collections/s/start-button-start-menu.md) | Updated the guideline for when to use bold formatting for *Start.* |
-| September 21, 2019 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) | Deleted *press and hold.* Clarified that *select and hold* is the correct term to use to describe pressing and holding a UI element. Added examples. |
+| June 30, 2020 | [hot link](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/h/hot-link) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [hot spot, hotspot](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/h/hot-spot-hotspot) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [jump](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/j/jump) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [later](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/l/later) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [navigate](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/n/navigate) | Updated guidance by replacing *hyperlink* with *link*.
+| June 30, 2020 | [shortcut, shortcut menu](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/shortcut-shortcut-menu) | Updated guidance by replacing *hyperlink* with *link*.
+| April 29, 2020 | [Describing alternative input methods](https://learn.microsoft.com/style-guide/procedures-instructions/describing-alternative-input-methods) | Updated example.
+| April 29, 2020 | [either/or](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/either-or) | Updated example.
+| April 29, 2020 | [Formatting text instructions](https://learn.microsoft.com/style-guide/procedures-instructions/formatting-text-in-instructions) | Revised table. Clarified wording for *Dialogue boxes* entry.
+| April 29, 2020 | [mixed reality, mixed-reality](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/mixed-reality) | Updated topic; removed acronym guidelines.
+| April 29, 2020 | [pane](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/pane) | Added guidelines regarding preposition use; "Use the preposition *on* when referring to the contents of a pane."
+| March 31, 2020 | [Capitalization](https://learn.microsoft.com/style-guide/capitalization) | Added guidance for hyphenated compound words |
+| March 31, 2020 | [Hyphens](https://learn.microsoft.com/style-guide/punctuation/dashes-hyphens/hyphens) | Updated list of examples. |
+| March 31, 2020 | [later](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/l/later) | Updated list of examples. |
+| March 31, 2020 | [multifactor authentication](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/multifactor-authentication) | Added guidance for *multifactor authentication*. |
+| March 31, 2020 | [Nouns and pronouns](https://learn.microsoft.com/style-guide/grammar/nouns-pronouns) | Added guidance for *they*. |
+| March 31, 2020 | [Numbers](https://learn.microsoft.com/style-guide/numbers) | Updated guidance on comma usage. |
+| March 31, 2020 | [runs vs. runs on](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/r/runs-vs-runs-on) | Updated list of examples. |
+| March 31, 2020 | [Units of measure terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/units-of-measure-terms) | Updated examples on Speed frequency. Also updated comma exceptions and examples. |
+| September 21, 2019 | [Mouse and mouse interaction term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms) | Added guidance for *scroll.* |
+| September 21, 2019 | [Start button, Start menu](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/start-button-start-menu) | Updated the guideline for when to use bold formatting for *Start.* |
+| September 21, 2019 | [Describing interactions with UI](https://learn.microsoft.com/style-guide/procedures-instructions/describing-interactions-with-ui) | Deleted *press and hold.* Clarified that *select and hold* is the correct term to use to describe pressing and holding a UI element. Added examples. |
| September 18, 2019 | [Numbers](~/numbers.md) | Added guidelines for using *K, M,* and *B* as abbreviations for *thousand, million,* and *billion.* |
| September 17, 2019 | [Microsoft](~/a-z-word-list-term-collections/m/microsoft.md) | Added a guideline about when to include *Microsoft* in references to product names. |
| September 13, 2019 | [Bias-free communication](~/bias-free-communication.md) [Nouns and pronouns](~/grammar/nouns-pronouns.md) | Clarified and expanded the guidelines for gender-neutral writing. |
From ddf732f0f10c89f0b8e5f76cf726aa93357c7839 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:34:15 -0500
Subject: [PATCH 371/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 57d50b72..6f6e13be 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -88,9 +88,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| September 21, 2019 | [Mouse and mouse interaction term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms) | Added guidance for *scroll.* |
| September 21, 2019 | [Start button, Start menu](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/start-button-start-menu) | Updated the guideline for when to use bold formatting for *Start.* |
| September 21, 2019 | [Describing interactions with UI](https://learn.microsoft.com/style-guide/procedures-instructions/describing-interactions-with-ui) | Deleted *press and hold.* Clarified that *select and hold* is the correct term to use to describe pressing and holding a UI element. Added examples. |
-| September 18, 2019 | [Numbers](~/numbers.md) | Added guidelines for using *K, M,* and *B* as abbreviations for *thousand, million,* and *billion.* |
-| September 17, 2019 | [Microsoft](~/a-z-word-list-term-collections/m/microsoft.md) | Added a guideline about when to include *Microsoft* in references to product names. |
-| September 13, 2019 | [Bias-free communication](~/bias-free-communication.md) [Nouns and pronouns](~/grammar/nouns-pronouns.md) | Clarified and expanded the guidelines for gender-neutral writing. |
+| September 18, 2019 | [Numbers](https://learn.microsoft.com/style-guide/numbers) | Added guidelines for using *K, M,* and *B* as abbreviations for *thousand, million,* and *billion.* |
+| September 17, 2019 | [Microsoft](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/microsoft) | Added a guideline about when to include *Microsoft* in references to product names. |
+| September 13, 2019 | [Bias-free communication](https://learn.microsoft.com/style-guide/bias-free-communication) | Clarified and expanded the guidelines for gender-neutral writing. |
| August 16, 2019 | [registry, registry settings](~/a-z-word-list-term-collections/r/registry-registry-settings.md) | Updated the examples. |
| August 8, 2019 | [author](~/a-z-word-list-term-collections/a/author.md) | Expanded this topic to say don't use *author* as a verb when you mean in general "to make something." Use a more precise verb. |
| August 8, 2019 | [Code examples](~/developer-content/code-examples.md) | Clarified the approach to creating code examples, including planning for and writing. (No change to the guidelines themselves.) |
From a2d00ed47a589c54683987e8866412bf74d8e7d2 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:42:46 -0500
Subject: [PATCH 372/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 50 ++++++++++++++++-----------------
1 file changed, 25 insertions(+), 25 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 6f6e13be..c9a045b3 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -91,32 +91,32 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| September 18, 2019 | [Numbers](https://learn.microsoft.com/style-guide/numbers) | Added guidelines for using *K, M,* and *B* as abbreviations for *thousand, million,* and *billion.* |
| September 17, 2019 | [Microsoft](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/microsoft) | Added a guideline about when to include *Microsoft* in references to product names. |
| September 13, 2019 | [Bias-free communication](https://learn.microsoft.com/style-guide/bias-free-communication) | Clarified and expanded the guidelines for gender-neutral writing. |
-| August 16, 2019 | [registry, registry settings](~/a-z-word-list-term-collections/r/registry-registry-settings.md) | Updated the examples. |
-| August 8, 2019 | [author](~/a-z-word-list-term-collections/a/author.md) | Expanded this topic to say don't use *author* as a verb when you mean in general "to make something." Use a more precise verb. |
-| August 8, 2019 | [Code examples](~/developer-content/code-examples.md) | Clarified the approach to creating code examples, including planning for and writing. (No change to the guidelines themselves.) |
-| August 8, 2019 | [Formatting developer text elements](~/developer-content/formatting-developer-text-elements.md) | Added updated examples and fixed some errors. |
-| August 8, 2019 | [Reference documentation](~/developer-content/reference-documentation.md) | Updated contents. Updated and added more examples. |
-| July 25, 2019 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) | Clarified the use of *select* and *enter* in describing user actions in instructions. Added examples. |
-| June 27, 2019 | [and so on](~/a-z-word-list-term-collections/a/and-so-on.md), [etc.](~/a-z-word-list-term-collections/e/etc.md) | Clarified that these terms shouldn't be used. Added examples of alternative wording. |
-| June 27, 2019 | [sign in, sign out](~/a-z-word-list-term-collections/s/sign-in-sign-out.md) | Added *sign into* and *log into* to the list of terms that shouldn't be used. Updated the examples. |
+| August 16, 2019 | [registry, registry settings](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/r/registry-registry-settings) | Updated the examples. |
+| August 8, 2019 | [author](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/a/author) | Expanded this topic to say don't use *author* as a verb when you mean in general "to make something." Use a more precise verb. |
+| August 8, 2019 | [Code examples](https://learn.microsoft.com/style-guide/developer-content/code-examples) | Clarified the approach to creating code examples, including planning for and writing. (No change to the guidelines themselves.) |
+| August 8, 2019 | [Formatting developer text elements](https://learn.microsoft.com/style-guide/developer-content/formatting-developer-text-elements) | Added updated examples and fixed some errors. |
+| August 8, 2019 | [Reference documentation](https://learn.microsoft.com/style-guide/developer-content/reference-documentation) | Updated contents. Updated and added more examples. |
+| July 25, 2019 | [Describing interactions with UI](https://learn.microsoft.com/style-guide/procedures-instructions/describing-interactions-with-ui) | Clarified the use of *select* and *enter* in describing user actions in instructions. Added examples. |
+| June 27, 2019 | [and so on](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/a/and-so-on) | Clarified that these terms shouldn't be used. Added examples of alternative wording. |
+| June 27, 2019 | [sign in, sign out](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/sign-in-sign-out) | Added *sign into* and *log into* to the list of terms that shouldn't be used. Updated the examples. |
| May 28, 2019 | "appears, displays" and "displays, appears" | Deleted these topics from the A–Z word list. Microsoft style no longer makes a recommendation for these terms. |
-| May 28, 2019 | [hard-code, hard-coded, hard-coding](~/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding.md) | Renamed the "hard-coded" topic so that the guideline applies to the additional word forms. |
-| May 28, 2019 | [passwordless](~/a-z-word-list-term-collections/p/passwordless.md) | Added a topic to the A–Z word list. |
-| May 6, 2019 | Global communications > [Names and contact information](~/global-communications/names-contact-information.md) | Added global considerations for content that addresses the customer by name, such as in email or the product UI. |
-| April 4, 2019 | [Date and time term collection](~/a-z-word-list-term-collections/term-collections/date-time-terms.md) | Added guidelines for abbreviating days of the week. Changed the guideline for month abbreviations to say don't use a period. |
-| April 1, 2019 | [mixed reality, mixed-reality](~/a-z-word-list-term-collections/m/mixed-reality.md) | Added a topic to the A–Z word list. |
-| April 1, 2019 | [fail over, fail back, failover, failback](~/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback.md) | Added a topic to the A–Z word list. |
-| April 1, 2019 | [single sign-on (SSO)](~/a-z-word-list-term-collections/s/single-sign-on-sso.md) | Added a topic to the A–Z word list. |
-| March 11, 2019 | [Commas](~/punctuation/commas.md) | Added guidelines for when to use a comma in a series of two or more adjectives that precede a noun. |
-| February 28, 2019 | [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md) | Added guidelines for using *desktop* as a hardware term. Updated the guidelines for *computer, PC, machine,* and other device terms. |
-| February 27, 2019 | [blade](~/a-z-word-list-term-collections/b/blade.md) | Clarified what the UI element called a *blade* is. Deleted the guideline to define *blade* on first mention. |
-| February 22, 2019 | [AI and bot term collection](~/a-z-word-list-term-collections/term-collections/ai-bot-terms.md) | Changed the name from "Bot term collection." Updated the guidelines for *bot, chatbot, virtual agent,* and *AI.* Added new guidelines for the terms *intelligent/intelligence* and *Microsoft AI.* |
-| February 1, 2019 | [Formatting developer text elements](~/developer-content/formatting-developer-text-elements.md) | Clarified the guideline for how to format UI text and updated the examples. |
-| February 1, 2019 | [Formatting common text elements](~/text-formatting/formatting-common-text-elements.md) | Clarified the guidelines for how to format error messages and UI text and how to refer to error messages in text. Updated the examples. |
-| February 1, 2019 | [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) | Added guidelines for how to refer to palettes and toggles when they're referenced in instructions. |
-| February 1, 2019 | [toggle](~/a-z-word-list-term-collections/t/toggle.md) | Clarified the guideline for how to refer to toggle keys and switches. |
-| February 1, 2019 | [palette](~/a-z-word-list-term-collections/p/palette.md) | Clarified the guideline for how to refer to palettes and updated the examples. |
-| January 18, 2019 | [Internet of Things (IoT)](~/a-z-word-list-term-collections/i/internet-of-things-iot.md) | Added a topic to the A–Z word list. |
+| May 28, 2019 | [hard-code, hard-coded, hard-coding](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding) | Renamed the "hard-coded" topic so that the guideline applies to the additional word forms. |
+| May 28, 2019 | [passwordless](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/passwordless) | Added a topic to the A–Z word list. |
+| May 6, 2019 | Global communications > [Names and contact information](https://learn.microsoft.com/style-guide/global-communications/names-contact-information) | Added global considerations for content that addresses the customer by name, such as in email or the product UI. |
+| April 4, 2019 | [Date and time term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Added guidelines for abbreviating days of the week. Changed the guideline for month abbreviations to say don't use a period. |
+| April 1, 2019 | [mixed reality, mixed-reality](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/mixed-reality) | Added a topic to the A–Z word list. |
+| April 1, 2019 | [fail over, fail back, failover, failback](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback) | Added a topic to the A–Z word list. |
+| April 1, 2019 | [single sign-on (SSO)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/s/single-sign-on-sso) | Added a topic to the A–Z word list. |
+| March 11, 2019 | [Commas](https://learn.microsoft.com/style-guide/punctuation/commas) | Added guidelines for when to use a comma in a series of two or more adjectives that precede a noun. |
+| February 28, 2019 | [Computer and device term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/computer-device-terms) | Added guidelines for using *desktop* as a hardware term. Updated the guidelines for *computer, PC, machine,* and other device terms. |
+| February 27, 2019 | [blade](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/b/blade) | Clarified what the UI element called a *blade* is. Deleted the guideline to define *blade* on first mention. |
+| February 22, 2019 | [AI and bot term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/ai-bot-terms) | Changed the name from "Bot term collection." Updated the guidelines for *bot, chatbot, virtual agent,* and *AI.* Added new guidelines for the terms *intelligent/intelligence* and *Microsoft AI.* |
+| February 1, 2019 | [Formatting developer text elements](https://learn.microsoft.com/style-guide/developer-content/formatting-developer-text-elements) | Clarified the guideline for how to format UI text and updated the examples. |
+| February 1, 2019 | [Formatting common text elements](https://learn.microsoft.com/style-guide/text-formatting/formatting-common-text-elements) | Clarified the guidelines for how to format error messages and UI text and how to refer to error messages in text. Updated the examples. |
+| February 1, 2019 | [Formatting text in instructions](https://learn.microsoft.com/style-guide/procedures-instructions/formatting-text-in-instructions) | Added guidelines for how to refer to palettes and toggles when they're referenced in instructions. |
+| February 1, 2019 | [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Clarified the guideline for how to refer to toggle keys and switches. |
+| February 1, 2019 | [palette](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/palette) | Clarified the guideline for how to refer to palettes and updated the examples. |
+| January 18, 2019 | [Internet of Things (IoT)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/i/internet-of-things-iot) | Added a topic to the A–Z word list. |
| December 12, 2018 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) [toggle](~/a-z-word-list-term-collections/t/toggle.md) | Updated the guidance for using *switch, turn on,* and *turn off* when describing actions involving toggle switches and toggle keys. Added examples. |
| November 27, 2018 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Updated the guideline to say that *hover over* is an acceptable alternative to *point to* and that *hover* is OK as an adjective. Added examples. |
| November 26, 2018 | [drill down, drill up, drill through](~/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md) | Added a topic to the A–Z word list. |
From 28be82d995b93be4c40ca3fb2868b77cf6807ea6 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:49:50 -0500
Subject: [PATCH 373/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index c9a045b3..c8c6771a 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -117,14 +117,14 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| February 1, 2019 | [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Clarified the guideline for how to refer to toggle keys and switches. |
| February 1, 2019 | [palette](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/palette) | Clarified the guideline for how to refer to palettes and updated the examples. |
| January 18, 2019 | [Internet of Things (IoT)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/i/internet-of-things-iot) | Added a topic to the A–Z word list. |
-| December 12, 2018 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) [toggle](~/a-z-word-list-term-collections/t/toggle.md) | Updated the guidance for using *switch, turn on,* and *turn off* when describing actions involving toggle switches and toggle keys. Added examples. |
-| November 27, 2018 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Updated the guideline to say that *hover over* is an acceptable alternative to *point to* and that *hover* is OK as an adjective. Added examples. |
-| November 26, 2018 | [drill down, drill up, drill through](~/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md) | Added a topic to the A–Z word list. |
-| November 26, 2018 | [avg](~/a-z-word-list-term-collections/a/avg.md) | Added a topic to the A–Z word list. |
-| November 8, 2018 | [e.g.](~/a-z-word-list-term-collections/e/eg.md) | Updated to say that *for example, such as,* and *like* are all OK to use instead of *e.g.* |
-| November 7, 2018 | [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) | Changed the guideline for key names, combinations, and sequences to say don't put a space around the plus sign (+) in keyboard shortcuts. Also, use bold formatting for key names and keyboard shortcuts when they appear in instructions. |
-| October 6, 2018 | [Tables](~/scannable-content/tables.md) | Clarified that a table must have two or more rows and two or more columns. Otherwise, use a list. |
-| October 4, 2018 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Changed the guideline to say that *mice* is the preferred plural of *mouse,* not *mouse devices.* |
-| September 11, 2018 | [org, organization](~/a-z-word-list-term-collections/o/org-organization.md) | Added a topic to the A–Z word list. |
-| September 11, 2018 | [company vs. organization](~/a-z-word-list-term-collections/c/company-vs-organization.md) | Added a topic to the A–Z word list. |
-| September 10, 2018 | [e-sports](~/a-z-word-list-term-collections/e/e-sports.md) | Added a topic to the A–Z word list. |
+| December 12, 2018 | [Describing interactions with UI](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui) [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Updated the guidance for using *switch, turn on,* and *turn off* when describing actions involving toggle switches and toggle keys. Added examples. |
+| November 27, 2018 | [Mouse and mouse interaction term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms) | Updated the guideline to say that *hover over* is an acceptable alternative to *point to* and that *hover* is OK as an adjective. Added examples. |
+| November 26, 2018 | [drill down, drill up, drill through](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through) | Added a topic to the A–Z word list. |
+| November 26, 2018 | [avg](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/a/avg) | Added a topic to the A–Z word list. |
+| November 8, 2018 | [e.g.](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/eg) | Updated to say that *for example, such as,* and *like* are all OK to use instead of *e.g.* |
+| November 7, 2018 | [Formatting text in instructions](https://learn.microsoft.com/style-guide/procedures-instructions/formatting-text-in-instructions) | Changed the guideline for key names, combinations, and sequences to say don't put a space around the plus sign (+) in keyboard shortcuts. Also, use bold formatting for key names and keyboard shortcuts when they appear in instructions. |
+| October 6, 2018 | [Tables](https://learn.microsoft.com/style-guide/scannable-content/tables) | Clarified that a table must have two or more rows and two or more columns. Otherwise, use a list. |
+| October 4, 2018 | [Mouse and mouse interaction term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms) | Changed the guideline to say that *mice* is the preferred plural of *mouse,* not *mouse devices.* |
+| September 11, 2018 | [org, organization](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/o/org-organization) | Added a topic to the A–Z word list. |
+| September 11, 2018 | [company vs. organization](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/c/company-vs-organization) | Added a topic to the A–Z word list. |
+| September 10, 2018 | [e-sports](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/e/e-sports) | Added a topic to the A–Z word list. |
From 823b8415cf4a6c8b325964206ee1cebcb4391218 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 09:50:38 -0500
Subject: [PATCH 374/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index c8c6771a..df3c9e72 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -117,7 +117,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| February 1, 2019 | [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Clarified the guideline for how to refer to toggle keys and switches. |
| February 1, 2019 | [palette](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/palette) | Clarified the guideline for how to refer to palettes and updated the examples. |
| January 18, 2019 | [Internet of Things (IoT)](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/i/internet-of-things-iot) | Added a topic to the A–Z word list. |
-| December 12, 2018 | [Describing interactions with UI](https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui) [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Updated the guidance for using *switch, turn on,* and *turn off* when describing actions involving toggle switches and toggle keys. Added examples. |
+| December 12, 2018 | [toggle](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/t/toggle) | Updated the guidance for using *switch, turn on,* and *turn off* when describing actions involving toggle switches and toggle keys. Added examples. |
| November 27, 2018 | [Mouse and mouse interaction term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms) | Updated the guideline to say that *hover over* is an acceptable alternative to *point to* and that *hover* is OK as an adjective. Added examples. |
| November 26, 2018 | [drill down, drill up, drill through](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/d/drill-down-drill-up-drill-through) | Added a topic to the A–Z word list. |
| November 26, 2018 | [avg](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/a/avg) | Added a topic to the A–Z word list. |
From 3cdcc632701af84fff462c46625f539f294cd98e Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Tue, 6 Jun 2023 12:14:40 -0500
Subject: [PATCH 375/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index df3c9e72..6b0d92fd 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -102,7 +102,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| May 28, 2019 | "appears, displays" and "displays, appears" | Deleted these topics from the A–Z word list. Microsoft style no longer makes a recommendation for these terms. |
| May 28, 2019 | [hard-code, hard-coded, hard-coding](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/h/hard-code-hard-coded-hard-coding) | Renamed the "hard-coded" topic so that the guideline applies to the additional word forms. |
| May 28, 2019 | [passwordless](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/p/passwordless) | Added a topic to the A–Z word list. |
-| May 6, 2019 | Global communications > [Names and contact information](https://learn.microsoft.com/style-guide/global-communications/names-contact-information) | Added global considerations for content that addresses the customer by name, such as in email or the product UI. |
+| May 6, 2019 | [Names and contact information](https://learn.microsoft.com/style-guide/global-communications/names-contact-information) | Added global considerations for content that addresses the customer by name, such as in email or the product UI. |
| April 4, 2019 | [Date and time term collection](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Added guidelines for abbreviating days of the week. Changed the guideline for month abbreviations to say don't use a period. |
| April 1, 2019 | [mixed reality, mixed-reality](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/m/mixed-reality) | Added a topic to the A–Z word list. |
| April 1, 2019 | [fail over, fail back, failover, failback](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/f/fail-over-fail-back-failover-failback) | Added a topic to the A–Z word list. |
From 8ea39a31e27bb120ced1edcc14b80ccd9e8f1a1d Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 14 Jun 2023 09:53:16 -0500
Subject: [PATCH 376/486] Update lists.md
---
styleguide/scannable-content/lists.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/scannable-content/lists.md b/styleguide/scannable-content/lists.md
index 894ebfb5..7bf7b4a4 100644
--- a/styleguide/scannable-content/lists.md
+++ b/styleguide/scannable-content/lists.md
@@ -3,7 +3,7 @@ title: Lists - Microsoft Style Guide
description: Discusses lists, which are a great way to present complex text in a way that's easy to scan. A list should have at least two items but no more than seven items.
author: pallep
ms.author: pallep
-ms.date: 08/09/2021
+ms.date: 06/14/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -34,7 +34,7 @@ Use a bulleted list for things that have something in common but don’t need to
## Numbered lists
Use a numbered list for sequential items (like a procedure) or prioritized items (like a top 10 list).
-**Example** **To sign on to a database**
+**Example** **To sign on to a database:**
1. On the **File** menu, select **Open database**.
2. In **Username**, enter your name.
From 3f8cb6d51cdb1647b99e75b24d7b9d6f083682ee Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 14 Jun 2023 10:04:46 -0500
Subject: [PATCH 377/486] Update pane.md
---
styleguide/a-z-word-list-term-collections/p/pane.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/p/pane.md b/styleguide/a-z-word-list-term-collections/p/pane.md
index 307a9aaf..1da905cf 100644
--- a/styleguide/a-z-word-list-term-collections/p/pane.md
+++ b/styleguide/a-z-word-list-term-collections/p/pane.md
@@ -3,7 +3,7 @@ title: pane - Microsoft Style Guide
description: Describes guidelines to use 'pane' in Microsoft documents and provides a link to commonly used interactions with UI terms.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 06/14/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -13,7 +13,7 @@ ms.prod: non-product-specific
Use
only to refer to the separate areas of a split or single window. For
example, in File Explorer, the names of all the folders sometimes appear
-in one pane and the contents of a selected folder in another pane.
+on one pane and the contents of a selected folder in another pane.
If a pane isn't labeled in the UI, use lowercase for the name that describes it, such as *the annotation pane*. If a pane is labeled in the UI, follow the capitalization used in the UI. For example, *the Score pane*.
From 14b844abf9f3aad76da87cd07e539002d723c622 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 14 Jun 2023 10:18:14 -0500
Subject: [PATCH 378/486] Update describing-alternative-input-methods.md
---
.../describing-alternative-input-methods.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/procedures-instructions/describing-alternative-input-methods.md b/styleguide/procedures-instructions/describing-alternative-input-methods.md
index 3f6dcb10..9f609ed5 100644
--- a/styleguide/procedures-instructions/describing-alternative-input-methods.md
+++ b/styleguide/procedures-instructions/describing-alternative-input-methods.md
@@ -3,7 +3,7 @@ title: Describing alternative input methods - Microsoft Style Guide
description: Discusses using input-neutral methods in instructions and providing an article that explains how to interact with the product using each available input method.
author: pallep
ms.author: pallep
-ms.date: 10/19/2022
+ms.date: 06/14/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -86,7 +86,7 @@ This table describes two ways to save a file.
| **To** | **Do this** |
|---|---|
| Save changes to the file and continue working. | On the **File** menu, click **Save**. |
-| Save changes to the file and close the program. | On the **File** menu, click **Exit**. If a dialog box asks whether you want to save changes, click **Yes**. |
+| Save changes to the file and close the program. | On the **File** menu, click **Exit**. If a dialog asks whether you want to save changes, click **Yes**. |
**If one step has an alternative,** make
that alternative a separate paragraph in the step. In a
From 105c90ef0e36f8935c818b4bb1bc3b8e3d9405ce Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 14 Jun 2023 10:19:49 -0500
Subject: [PATCH 379/486] Update describing-interactions-with-ui.md
---
.../describing-interactions-with-ui.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/procedures-instructions/describing-interactions-with-ui.md b/styleguide/procedures-instructions/describing-interactions-with-ui.md
index c5afba9e..30c54799 100644
--- a/styleguide/procedures-instructions/describing-interactions-with-ui.md
+++ b/styleguide/procedures-instructions/describing-interactions-with-ui.md
@@ -3,7 +3,7 @@ title: Describing interactions with UI - Microsoft Style Guide
description: Describes how to refer to various interactions with UI and provides a table that outlines various verbs to use and examples of how to use them in content.
author: pallep
ms.author: pallep
-ms.date: 10/19/2022
+ms.date: 06/14/2023
ms.topic: article
ms.prod: non-product-specific
---
@@ -21,7 +21,7 @@ input method. Don't use input-specific verbs, such as *click* or *swipe*. Instea
| **Verb** | **Use for** | **Examples** |
|---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Open** |
Apps and programs
Blades
File Explorer
Files and folders
Shortcut menus
Use for websites and webpages only when necessary to match the UI. Otherwise, use go to.
Don't use for commands and menus.
|
Open Photos.
Open the Reader app.
Select Users + groups to open the blade.
Open the Filename file.
To open the document in Outline view, select View > Outline.
In WindowName, open the shortcut menu for ItemName.
|
-| **Close** |
Apps and programs
Blades
Dialog boxes
Files and folders
Notifications and alerts
Tabs
The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with stop responding.)
|
Close the Alarms app.
Close Excel.
Close the blade.
Close the Users + groups blade.
Save and close the document.
Closing Excel also closes all open worksheets.
|
+| **Close** |
Apps and programs
Blades
Dialogs
Files and folders
Notifications and alerts
Tabs
The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with stop responding.)
|
Close the Alarms app.
Close Excel.
Close the blade.
Close the Users + groups blade.
Save and close the document.
Closing Excel also closes all open worksheets.
|
| **Leave** | Websites and webpages | Select **Submit** to complete the survey and leave this page. |
| **Go to** |
Opening a menu.
Going to a tab or another particular place in the UI.
Going to a website or webpage.
It's OK to use On theXXXtab if the instruction is brief and continues immediately.
|
Go to Search :::image type="icon" source="media/describing-interactions-with-ui/721771267.png":::, enter the word settings, and then select Settings.
Go to File, and then select Close.
On the ribbon, go to the Design tab.
Go to the Deploy tab. In the Configuration list …
On the Deploy tab, in the Configuration list …
Go to Example.com to register.
|
| **Select** | Instructing the customer to select a specific item, including:
Selecting an option, such as a button.
Selecting a checkbox.
Selecting a value from a list box.
Selecting link text to go to a link.
Selecting an item on a menu or shortcut menu.
Selecting an item from a gallery.
Selecting keys and keyboard shortcuts. (Document keyboard shortcuts only if they're the most likely way the customer will accomplish a task or as an alternative input method, usually in a separate keyboard shortcuts article.)
|
Select the Modify button.
For Alignment, select Left.
Select the text, open the shortcut menu, and then select Font.
Select Open in new tab.
Select the LinkName link.
Select **F5**.
Select **Shift+Enter**.
Select **Ctrl+Alt+Delete**.
|
@@ -31,6 +31,6 @@ input method. Don't use input-specific verbs, such as *click* or *swipe*. Instea
| **Choose** | Choosing an option, based on the customer's preference or desired outcome. | On the **Font** tab, choose the effects you want. |
| **Switch, turn on, turn off** | Turning a toggle key or toggle switch on or off. |
Use the **Caps lock** key to switch from typing capital letters to typing lowercase letters.
To switch between Normal, Outline, and Slide Sorter views, use the buttons on the View tab.
To make text and apps easier to see, turn on the toggle under Turn on high contrast.
To keep all applied filters, turn on the Pass all filters toggle.
|
| **Enter** | Instructing the customer to type or otherwise insert a value, or to type or select a value in a combo box. |
In the search box, enter…
In the **Tab stop position** box, enter the location where you want to set the new tab.
In the **Deployment script name** box, enter a name for this script.
|
-| **Move, drag** | Moving anything from one place to another by dragging, cutting and pasting, or another method. Use for tiles and any open window (including apps, dialog boxes, files, and blades).
Use *move through* to describe moving around on a page, moving through screens or pages in an app, or moving up, down, right, and left in a UI. |
Drag the Filename file to the Foldername folder.
Move the tile to the new section.
Drag the Snipping Tool out of the way, if necessary, and then select the area you want to capture.
If the Apply Styles task pane is in your way, just move it.
|
+| **Move, drag** | Moving anything from one place to another by dragging, cutting and pasting, or another method. Use for tiles and any open window (including apps, dialogs, files, and blades).
Use *move through* to describe moving around on a page, moving through screens or pages in an app, or moving up, down, right, and left in a UI. |
Drag the Filename file to the Foldername folder.
Move the tile to the new section.
Drag the Snipping Tool out of the way, if necessary, and then select the area you want to capture.
If the Apply Styles task pane is in your way, just move it.
|
| **Zoom, zoom in, zoom out** | Use *zoom,* *zoom in,* and *zoom out* to refer to changing the magnification of the screen or window. |
Zoom in to see more details on the map.
Zoom out to see a larger geographic area on the map.
@@ -103,7 +103,7 @@ Use an en dash (–) instead of a hyphen in a compound adjective when:
## Prefixes
-Avoid creating new words by adding prefixes to existing words. Rewrite to avoid creating a new word. If a word with a prefix is listed in [*The American Heritage Dictionary*](https://ahdictionary.com/) or the A–Z word list, it’s OK to use in Microsoft content.
+Avoid creating new words by adding prefixes to existing words. Rewrite to avoid creating a new word. If a word with a prefix is listed in *[Merriam-Webster Dictionary](https://merriam-webster.com/)* or the A–Z word list, it’s OK to use in Microsoft content.
In general, don’t include a hyphen after the following prefixes unless omitting the hyphen could confuse the reader.
From b82d38fe2e330c1dba5f641533c9d3b3d2c38dee Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 14:21:40 -0500
Subject: [PATCH 458/486] Update auto.md
---
styleguide/a-z-word-list-term-collections/a/auto.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/a/auto.md b/styleguide/a-z-word-list-term-collections/a/auto.md
index 157bf356..4c9508bd 100644
--- a/styleguide/a-z-word-list-term-collections/a/auto.md
+++ b/styleguide/a-z-word-list-term-collections/a/auto.md
@@ -3,14 +3,14 @@ title: Auto- - Microsoft Style Guide
description: This article outlines use of the word auto per Microsoft style guidelines.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# auto-
-In general, don’t hyphenate words beginning with *auto-,* such as *autoscale* and *autodial,* unless it's necessary to avoid confusion. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *auto-,* such as *autoscale* and *autodial,* unless it's necessary to avoid confusion. When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
Don’t create new words beginning with *auto-.*
From 13ed76afd501e169830dacb5f641752da6eecd60 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 14:22:06 -0500
Subject: [PATCH 459/486] Update bi.md
---
styleguide/a-z-word-list-term-collections/b/bi.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/b/bi.md b/styleguide/a-z-word-list-term-collections/b/bi.md
index 435fb51f..5d9c684d 100644
--- a/styleguide/a-z-word-list-term-collections/b/bi.md
+++ b/styleguide/a-z-word-list-term-collections/b/bi.md
@@ -3,13 +3,13 @@ title: Bi- - Microsoft Style Guide
description: This article outlines use of the bi- prefix per Microsoft style guidelines.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# Bi-
-In general, don't hyphenate words beginning with *bi-,* such as *bidirectional,* *bimodal,* and *bimonthly,* unless it's necessary to avoid confusion. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don't hyphenate words beginning with *bi-,* such as *bidirectional,* *bimodal,* and *bimonthly,* unless it's necessary to avoid confusion. When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 4497202fd9386a112fd2a6cee8bc1e1a3acc1527 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 14:22:34 -0500
Subject: [PATCH 460/486] Update co.md
---
styleguide/a-z-word-list-term-collections/c/co.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/c/co.md b/styleguide/a-z-word-list-term-collections/c/co.md
index fd45deb8..a3d56433 100644
--- a/styleguide/a-z-word-list-term-collections/c/co.md
+++ b/styleguide/a-z-word-list-term-collections/c/co.md
@@ -3,13 +3,13 @@ title: co- - Microsoft Style Guide
description: Describes how to use the prefix 'co-' with words in Microsoft content and clarifies when to hyphenate the prefix.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# co-
-In general, don’t hyphenate words beginning with *co-,* such as *coauthor* and *coordinate,* unless it’s necessary to avoid confusion. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *co-,* such as *coauthor* and *coordinate,* unless it’s necessary to avoid confusion. When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 5807f920da24fa5b5706c32046fa05c99c1860f6 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:53:48 -0500
Subject: [PATCH 461/486] Update e-words.md
---
styleguide/a-z-word-list-term-collections/e/e-words.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/e/e-words.md b/styleguide/a-z-word-list-term-collections/e/e-words.md
index c365b386..d008a0c0 100644
--- a/styleguide/a-z-word-list-term-collections/e/e-words.md
+++ b/styleguide/a-z-word-list-term-collections/e/e-words.md
@@ -3,7 +3,7 @@ title: e-words - Microsoft Style Guide
description: Describes guidelines to use 'e-words' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -12,7 +12,7 @@ ms.service: microsoft-writing-style-guide
Don't create new words with *e-* (for *electronic*).
-It's OK to use e-words, such as *e-book* and *e-commerce,* that are included in this guide and in [*The American Heritage Dictionary*](https://ahdictionary.com/).
+It's OK to use e-words, such as *e-book* and *e-commerce,* that are included in this guide and in *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
Almost all e-words are hyphenated. *Email* is an exception.
From d4f51bdf5b3e0af0d085f32075d9842a82b8f208 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:54:40 -0500
Subject: [PATCH 462/486] Update micro.md
---
styleguide/a-z-word-list-term-collections/m/micro.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/m/micro.md b/styleguide/a-z-word-list-term-collections/m/micro.md
index 93bef21f..382638a1 100644
--- a/styleguide/a-z-word-list-term-collections/m/micro.md
+++ b/styleguide/a-z-word-list-term-collections/m/micro.md
@@ -3,13 +3,13 @@ title: micro- - Microsoft Style Guide
description: Describes guidelines to use 'micro-' in Microsoft documents and provides alternate examples.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# micro-
-In general, don't hyphenate words beginning with *micro-,* such as *microprocessor* and *microsecond,* unless it's necessary to avoid confusion. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don't hyphenate words beginning with *micro-,* such as *microprocessor* and *microsecond,* unless it's necessary to avoid confusion. When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 27e70ffa3577db52e3118ee07ec7db52c3ee50fb Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:55:58 -0500
Subject: [PATCH 463/486] Update multi.md
---
styleguide/a-z-word-list-term-collections/m/multi.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/m/multi.md b/styleguide/a-z-word-list-term-collections/m/multi.md
index 8d90e749..e77e2d4f 100644
--- a/styleguide/a-z-word-list-term-collections/m/multi.md
+++ b/styleguide/a-z-word-list-term-collections/m/multi.md
@@ -3,7 +3,7 @@ title: multi- - Microsoft Style Guide
description: Describes guidelines to use the suffix 'multi-' in Microsoft documents and provides multiple examples.
author: pallep
ms.author: pallep
-ms.date: 02/22/2024
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -12,7 +12,7 @@ ms.service: microsoft-writing-style-guide
In general, don't hyphenate words beginning with *multi-* unless it's necessary to avoid confusion or *multi-* is followed by a proper noun.
-Don't invent new words by combining words with multi-. Check [*The American Heritage Dictionary*](https://ahdictionary.com/). If you don't find the word there or in the following list of examples, use *multiple* before the word instead.
+Don't invent new words by combining words with multi-. Check *[Merriam-Webster Dictionary](https://merriam-webster.com/).* If you don't find the word there or in the following list of examples, use *multiple* before the word instead.
**Examples** multicast multichannel multicloud multicolumn multiline multiprocessor
From c7ee6aaf2501a14a8822e7a03cf9bd7469c5f158 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:57:24 -0500
Subject: [PATCH 464/486] Update non.md
---
styleguide/a-z-word-list-term-collections/n/non.md | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/n/non.md b/styleguide/a-z-word-list-term-collections/n/non.md
index 957cc447..572a0b65 100644
--- a/styleguide/a-z-word-list-term-collections/n/non.md
+++ b/styleguide/a-z-word-list-term-collections/n/non.md
@@ -3,15 +3,14 @@ title: non- - Microsoft Style Guide
description: Describes guidelines to use the prefix 'non-' in Microsoft documents and provides examples.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# non-
-Don't hyphenate words beginning with *non-,* such as *nonnumeric* and *nonzero,* unless a hyphen is necessary to avoid confusion, as in *non-native,* or *non-* is followed by a proper noun, as in *non-English.* When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
-
+Don't hyphenate words beginning with *non-,* such as *nonnumeric* and *nonzero,* unless a hyphen is necessary to avoid confusion, as in *non-native,* or *non-* is followed by a proper noun, as in *non-English.* When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
Don't use *non-* to negate an entire phrase.
**Example**
From 4a937b71b9259680e7644e02bd571fc594f53251 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:58:38 -0500
Subject: [PATCH 465/486] Update pre.md
---
styleguide/a-z-word-list-term-collections/p/pre.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/p/pre.md b/styleguide/a-z-word-list-term-collections/p/pre.md
index 6737ed5b..9f085478 100644
--- a/styleguide/a-z-word-list-term-collections/p/pre.md
+++ b/styleguide/a-z-word-list-term-collections/p/pre.md
@@ -3,13 +3,13 @@ title: pre- - Microsoft Style Guide
description: Describes how to use the prefix "pre" in Microsoft content.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# pre-
-In general, don’t hyphenate words beginning with *pre-,* such as *preallocate* and *preempt,* unless it’s necessary to avoid confusion, as in *pre-engineered,* or if *pre-* is followed by a proper noun, as in *pre-C++.* When in doubt, refer to [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *pre-,* such as *preallocate* and *preempt,* unless it’s necessary to avoid confusion, as in *pre-engineered,* or if *pre-* is followed by a proper noun, as in *pre-C++.* When in doubt, refer to *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 6e84f68ec29216b92f404b36673f7ec2ff76f852 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 15:59:03 -0500
Subject: [PATCH 466/486] Update re.md
---
styleguide/a-z-word-list-term-collections/r/re.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/r/re.md b/styleguide/a-z-word-list-term-collections/r/re.md
index 1669c216..35a87f54 100644
--- a/styleguide/a-z-word-list-term-collections/r/re.md
+++ b/styleguide/a-z-word-list-term-collections/r/re.md
@@ -3,14 +3,14 @@ title: re- - Microsoft Style Guide
description: In this article, learn about guidelines for using 're-' as a hyphenate in Microsoft documents and where to find more information about hyphenation.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# re-
-In general, don’t hyphenate words beginning with *re-* unless it’s necessary to avoid confusion or *re-* is followed by a proper noun. When in doubt, refer to [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *re-* unless it’s necessary to avoid confusion or *re-* is followed by a proper noun. When in doubt, refer to *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
**Examples**
reenter
From 901595c9fd585b01fca29595a8b77e6eaaf9885a Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:05:21 -0500
Subject: [PATCH 467/486] Update sub.md
---
styleguide/a-z-word-list-term-collections/s/sub.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/sub.md b/styleguide/a-z-word-list-term-collections/s/sub.md
index 262fccf8..db9d48ca 100644
--- a/styleguide/a-z-word-list-term-collections/s/sub.md
+++ b/styleguide/a-z-word-list-term-collections/s/sub.md
@@ -3,13 +3,13 @@ title: sub- - Microsoft Style Guide
description: Describes guidelines to use 'sub-' in Microsoft documents, and provides a link to learn more about hyphenation.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# sub-
-In general, don’t hyphenate words beginning with *sub-,* such as *subheading* and *subsection,* unless it’s necessary to avoid confusion or if *sub-* is followed by a proper noun, as in *sub-Saharan*. When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *sub-,* such as *subheading* and *subsection,* unless it’s necessary to avoid confusion or if *sub-* is followed by a proper noun, as in *sub-Saharan*. When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 4608dc1b1e834c17a5c5f3b20f0e883ffa9ea30f Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:05:44 -0500
Subject: [PATCH 468/486] Update un.md
---
styleguide/a-z-word-list-term-collections/u/un.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/u/un.md b/styleguide/a-z-word-list-term-collections/u/un.md
index a8d827ec..2b972a1d 100644
--- a/styleguide/a-z-word-list-term-collections/u/un.md
+++ b/styleguide/a-z-word-list-term-collections/u/un.md
@@ -3,13 +3,13 @@ title: un- - Microsoft Style Guide
description: Describes how to implement the 'un-' hyphen in Microsoft content and provides a link to the Hyphens topic.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# un-
-In general, don’t hyphenate words beginning with *un-,* such as *undo* and *unread,* unless it’s necessary to avoid confusion, as in *un-ionized,* or unless *un-* is followed by a proper noun, as in *un-American.* When in doubt, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+In general, don’t hyphenate words beginning with *un-,* such as *undo* and *unread,* unless it’s necessary to avoid confusion, as in *un-ionized,* or unless *un-* is followed by a proper noun, as in *un-American.* When in doubt, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md).
From 642ef9f6f70729dda869b45b6e4fb1279cbd0632 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:07:12 -0500
Subject: [PATCH 469/486] Update capitalization.md
---
styleguide/capitalization.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/capitalization.md b/styleguide/capitalization.md
index ec23e61f..1e373b28 100644
--- a/styleguide/capitalization.md
+++ b/styleguide/capitalization.md
@@ -3,7 +3,7 @@ title: Capitalization - Microsoft Style Guide
description: Microsoft style uses sentence-style capitalization. That means everything is lowercase except the first word and proper nouns.
author: pallep
ms.author: pallep
-ms.date: 04/02/2021
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -43,7 +43,7 @@ Follow these guidelines in Microsoft content:
- For information on capitalization in hyphenated compound words see [Hyphens](punctuation/dashes-hyphens/hyphens.md).
-**Learn more** To learn more about capitalization, see [*The Chicago Manual of Style*](http://www.chicagomanualofstyle.org/home.html). If you're not sure whether to capitalize a term, check the A–Z word list and [*The American Heritage Dictionary*](https://ahdictionary.com/).
+**Learn more** To learn more about capitalization, see [*The Chicago Manual of Style*](http://www.chicagomanualofstyle.org/home.html). If you're not sure whether to capitalize a term, check the A–Z word list and *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
For information about capitalizing UI labels in instructions, see [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md).
From f8edbbfb4f273621be2f269574bd589f8779612c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:08:13 -0500
Subject: [PATCH 470/486] Update acronyms.md
---
styleguide/acronyms.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/acronyms.md b/styleguide/acronyms.md
index 09fd709a..94cb5a8e 100644
--- a/styleguide/acronyms.md
+++ b/styleguide/acronyms.md
@@ -3,7 +3,7 @@ title: Acronyms - Microsoft Style Guide
description: This article describes how to write acronyms and abbreviations per Microsoft style guidelines, with examples.
author: pallep
ms.author: pallep
-ms.date: 10/19/2022
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -21,7 +21,7 @@ Always spell out Microsoft product and feature names.
## Only use acronyms that your audience is familiar with
-The A–Z word list has guidelines for many common acronyms, and some acronyms are so widely used that they're in *[The American Heritage Dictionary](https://ahdictionary.com/).*
+The A–Z word list has guidelines for many common acronyms, and some acronyms are so widely used that they're in *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
## If you have to use an acronym, also spell out the term for clarity
@@ -29,7 +29,7 @@ In general, include the acronym in parentheses following the spelled-out
term. On subsequent mentions in the same article, page, or screen, you can
use the acronym without spelling it out.
-Some acronyms, like *USB, FAQ,* and *URL,* are more well known than the spelled-out term. Don't spell out the term if the acronym is listed in *[The American Heritage Dictionary](https://ahdictionary.com/)* or if the A–Z word list
+Some acronyms, like *USB, FAQ,* and *URL,* are more well known than the spelled-out term. Don't spell out the term if the acronym is listed in *[Merriam-Webster Dictionary](https://merriam-webster.com/)* or if the A–Z word list
says to use the acronym without spelling it out. If you're sure your
audience is familiar with an acronym, it's OK to use it without spelling
it out.
From 62a5eb96726e53358e0dbffb783f7baff5fe3929 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:08:50 -0500
Subject: [PATCH 471/486] Update dont-use-common-words-in-new-ways.md
---
styleguide/word-choice/dont-use-common-words-in-new-ways.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/word-choice/dont-use-common-words-in-new-ways.md b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
index f4be7904..70f6cd5a 100644
--- a/styleguide/word-choice/dont-use-common-words-in-new-ways.md
+++ b/styleguide/word-choice/dont-use-common-words-in-new-ways.md
@@ -3,7 +3,7 @@ title: Don't use common words in new ways - Microsoft Style Guide
description: Instructs not to use common words in new ways, such as bucketize to mean group, and to be careful with common words that have industry-specific uses.
author: pallep
ms.author: pallep
-ms.date: 08/25/2021
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -11,7 +11,7 @@ ms.service: microsoft-writing-style-guide
# Don't use common words in new ways
-Most people know the common definition of words—usually the one that appears first in the dictionary. Refer to [*The American Heritage Dictionary*](https://ahdictionary.com/) if you have any doubts. Use words in the most familiar sense, or define them if you can’t.
+Most people know the common definition of words—usually the one that appears first in the dictionary. Refer to *[Merriam-Webster Dictionary](https://merriam-webster.com/)* if you have any doubts. Use words in the most familiar sense, or define them if you can’t.
- Don’t create a new word from an existing word.
From 13335b016563395ce4b9a9325610b524c7d28861 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:09:29 -0500
Subject: [PATCH 472/486] Update use-technical-terms-carefully.md
---
styleguide/word-choice/use-technical-terms-carefully.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/styleguide/word-choice/use-technical-terms-carefully.md b/styleguide/word-choice/use-technical-terms-carefully.md
index 1eda83ef..d7b1e637 100644
--- a/styleguide/word-choice/use-technical-terms-carefully.md
+++ b/styleguide/word-choice/use-technical-terms-carefully.md
@@ -3,7 +3,7 @@ title: Use technical terms carefully - Microsoft Style Guide
description: Instructs to use technical terms carefully. Use them when they're the clearest way to communicate your message, but don't use them when an everyday term will do.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -36,7 +36,7 @@ healthcare, construction, IT, and project management, for example.
If
you're writing for an industry or profession, use the words your
audience uses. First, verify Microsoft and industry usage. Check
-the A–Z word list and [*The American Heritage Dictionary*](https://ahdictionary.com/). Then look to authoritative industry resources:
+the A–Z word list and *[Merriam-Webster Dictionary](https://merriam-webster.com/).* Then look to authoritative industry resources:
- Terminology websites, such as [Webopedia.com](https://www.webopedia.com/), and [Whatis.TechTarget.com](https://whatis.techtarget.com/).
@@ -62,6 +62,6 @@ consistently across our products, services, documents, packaging, and
marketing. Before you adopt a new term in your content, find
out whether other groups are using it, and how.
- - First, check [*The American Heritage Dictionary*](https://ahdictionary.com/).
+ - First, check *[Merriam-Webster Dictionary](https://merriam-webster.com/).*
- Research the term on *edited* industry websites, such as [Forrester Research](https://www.forrester.com/home/), [Gartner](https://www.gartner.com/technology/home.jsp), [CNET](https://www.cnet.com/), [Recode](https://www.recode.net/), [Mashable](https://mashable.com/), [TechCrunch](https://techcrunch.com/), [WIRED](https://www.wired.com/), [Gizmodo](https://gizmodo.com/), [HuffPost Tech](https://www.huffingtonpost.com/tech/), and [Engadget](https://www.engadget.com/). For emerging industry terminology, check reputable business and trade websites, such as [Fast Company](https://www.fastcompany.com/), [Entrepreneur](https://www.entrepreneur.com/magazine/index.html), [Business Insider](https://www.businessinsider.com/), [Healthcare IT News](https://www.healthcareitnews.com/), [American Banker](https://www.americanbanker.com/bank-technology/), and [GameSpot](https://www.gamespot.com/news/).
From 0f9e5bd212ef8fc2aa8a2c26ed3e24ffcd9b66fc Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:12:11 -0500
Subject: [PATCH 473/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 3fda5ec9..70945919 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 06/25/2024
+ms.date: 08/26/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -15,6 +15,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| August 26, 2024 | [Announcement] | The Microsoft Writing Style Guide has now aligned with Merriam-Webster as its dictionary of references. Links and mentions have been fixed globally.
| June 25, 2024 | [prompt, prompting](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/prompt) | Updated guidance to address new concerns about AI prompts and provide resources for prompt writing.
| May 9, 2024 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Added guidance to avoid the use of "special needs."
| April 19, 2024 | [Copilot, copilot](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/c/copilot-copilot) | Created new topic with information on how to use Microsoft Copilot versus third-party copilots in naming and descriptions.
From 622560ad9cabe4e0218145324bb4f7587473f386 Mon Sep 17 00:00:00 2001
From: Tianqi Zhang
Date: Tue, 3 Sep 2024 14:28:57 +0800
Subject: [PATCH 474/486] Add no_index_ks meta to exclude this repo from
Knowledge Service
---
styleguide/docfx.json | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/docfx.json b/styleguide/docfx.json
index 9c2693b2..60e46c0f 100644
--- a/styleguide/docfx.json
+++ b/styleguide/docfx.json
@@ -39,6 +39,7 @@
],
"feedback_system": "GitHub",
"feedback_github_repo": "MicrosoftDocs/microsoft-style-guide",
+ "no_index_ks": true
},
"fileMetadata": {},
"template": [],
From 564beaa58d30e6cd08d77586b820662947395d29 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Thu, 5 Sep 2024 12:46:50 -0500
Subject: [PATCH 475/486] Update top-10-tips-style-voice.md
---
styleguide/top-10-tips-style-voice.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/top-10-tips-style-voice.md b/styleguide/top-10-tips-style-voice.md
index 5b7e1f1f..29dbbe7a 100644
--- a/styleguide/top-10-tips-style-voice.md
+++ b/styleguide/top-10-tips-style-voice.md
@@ -3,7 +3,7 @@ title: Top 10 tips for Microsoft style and voice - Microsoft Style Guide
description: Instructs to use bigger ideas, fewer words, write like you speak, project friendliness and get to the point fast.
author: pallep
ms.author: pallep
-ms.date: 01/19/2023
+ms.date: 09/05/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -72,7 +72,7 @@ Capitalization (Like This). Never Ever. To learn more, see [Capitalization](~/ca
With these: Find a Microsoft partner Office 365 customer Limited-time offer Join us online
## Skip periods (and : \! ?)
-Skip end punctuation on titles, headings, subheads, UI titles, and
+Skip end punctuation on titles, headings, subheadings, UI titles, and
items in a list that are three or fewer words. Save the periods for
paragraphs and body copy. To learn more, see [Punctuation](~/punctuation/index.md), [Headings](~/scannable-content/headings.md), and [Lists](~/scannable-content/lists.md).
From 7a1b2d492fcbd1fb8e74d4e195b06dbd4caf5d32 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Mon, 23 Sep 2024 09:08:09 -0500
Subject: [PATCH 476/486] Update index.md
---
styleguide/word-choice/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/styleguide/word-choice/index.md b/styleguide/word-choice/index.md
index 3eab25ba..f6b6d0c5 100644
--- a/styleguide/word-choice/index.md
+++ b/styleguide/word-choice/index.md
@@ -3,7 +3,7 @@ title: Word choice - Microsoft Style Guide
description: Instructs that to improve readability and comprehension, choose your words wisely and use them consistently. If you mean the same thing, use the same word.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 09/23/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -24,4 +24,4 @@ This section provides tips for choosing the right words for the job:
- [Avoid jargon](~/word-choice/avoid-jargon.md)
- [Use US spelling and avoid non-English words](~/word-choice/use-us-spelling-avoid-non-english-words.md)
-For information about specific words and phrases, refer to the A–Z word list and [*The American Heritage Dictionary*](https://ahdictionary.com/).
+For information about specific words and phrases, refer to the A–Z word list and [*Merriam-Webster Dictionary*](https://www.merriam-webster.com/).
From 4de48e6794d2ce6d56b6ff8064e1e8350eb8855c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:05:06 -0500
Subject: [PATCH 477/486] Update disk-space.md
---
.../a-z-word-list-term-collections/d/disk-space.md | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-space.md b/styleguide/a-z-word-list-term-collections/d/disk-space.md
index 0813321b..42825c57 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-space.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-space.md
@@ -3,13 +3,19 @@ title: disk space - Microsoft Style Guide
description: In Microsoft documents, use 'disk space' instead of 'storage' or 'memory' to refer to available capacity on a disk.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/16/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# disk space
-Use instead of *storage* or *memory* to refer to available capacity on a disk.
+In general, avoid. Use *storage* or *storage space* to refer to available capacity on a drive.
+
+When referring to storage in a partition of space, mention it specifically and use *drive* instead of *disk*.
+
+**Example**
+
+Storage in local drive (C:)
**See also** [storage, storage device](~/a-z-word-list-term-collections/s/storage-storage-device.md)
From c03184bd6605424ecee534c91009216f1edff22c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:06:26 -0500
Subject: [PATCH 478/486] Update storage-storage-device.md
---
.../s/storage-storage-device.md | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md b/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
index fcd9f10a..1b084cae 100644
--- a/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
+++ b/styleguide/a-z-word-list-term-collections/s/storage-storage-device.md
@@ -1,15 +1,17 @@
---
-title: storage, storage device - Microsoft Style Guide
-description: Describes guidelines to use 'storage' or 'storage device' in Microsoft documents.
+title: storage, storage space - Microsoft Style Guide
+description: Describes guidelines to use 'storage' or 'storage space' in Microsoft documents.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/17/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
-# storage, storage device
+# storage, storage space
-Don't use *storage* to refer to available space on a disk. Use *disk space* instead.
+Use *storage* or *storage space* to refer to local capacity on a device.
It's OK to use *storage device* to refer generally to external drives, USB drives, and other types of storage hardware.
+
+When referring to cloud, use *cloud storage* or refer to the specific cloud provider storage in OneDrive instead.
From 5c5575ef23960a619c2cebbd5b54e21c2e01eec5 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:13:21 -0500
Subject: [PATCH 479/486] Update quotation-marks.md
---
styleguide/punctuation/quotation-marks.md | 36 ++++++++++-------------
1 file changed, 16 insertions(+), 20 deletions(-)
diff --git a/styleguide/punctuation/quotation-marks.md b/styleguide/punctuation/quotation-marks.md
index 204ef3a8..faf06cfa 100644
--- a/styleguide/punctuation/quotation-marks.md
+++ b/styleguide/punctuation/quotation-marks.md
@@ -1,37 +1,33 @@
---
title: Quotation marks - Microsoft Style Guide
-description: Discusses that in most content, use double quotation marks (" ") not single quotation marks (' '). In online content, use straight quotation marks.
+description: Discusses that in most content, use double quotation marks (" ") not single quotation marks (' '). In most content, use straight quotation marks.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/17/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
# Quotation marks
-In most content, use double quotation marks (" ") not single quotation marks (' ').
-
-In
-printed content, use curly quotation marks (“ ”) except in
-user input and code samples, which call for straight quotation
-marks (" "). If your project style sheet requires
-straight quotation marks with sans serif fonts, such as in
-headings, follow the style sheet.
-
-In online content, use straight quotation marks.
-
-Refer to *quotation marks, opening quotation marks,* and *closing quotation marks.* Don't call them *quote marks, quotes, open* or *close quotation marks,* or *beginning* or *ending quotation marks.*
+Use single quotation marks (' ') to indicate quoted material within a quotation. Double and single straight quotation marks can also be used to indicate feet and inches, respectively.
Place closing quotation marks:
- Outside commas and periods.
- Inside other punctuation.
+
+**Exception** If punctuation is part of the quoted material, place it inside the quotation marks.
-**Exception** If punctuation is part of the quoted material, place it inside the quotation marks.
+**Examples**
+One type of malware is called a "trojan clicker."
+He explained: "One type of malware, called a 'trojan clicker,' uses your PC to 'click' online ads.'
+Use an 8.5" x 11" sheet of paper.
+
+**Quotation marks in Segoe**
+Use straight quotation marks (" "). Segoe Sans, the Microsoft font family, does not have a curly quotation mark option.
+
+**Preferred terms**
+
+Refer to *quotation marks, opening quotation marks,* and *closing quotation marks.* Don't call them *quote marks, quotes, open* or *close quotation marks,* or *beginning* or *ending quotation marks.*
-**Examples**
-One type of malware is called a "trojan clicker."
-One type of malware, called a "trojan clicker," uses your PC to "click" online ads.
-What is "gaze awareness"?
-A reader asks, "How can I get Windows 10?"
From 6a1de916c3c08bfc6011cf2fcb2c2664537fac02 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:21:48 -0500
Subject: [PATCH 480/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index 70945919..ba24b06d 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -3,7 +3,7 @@ title: What's new? - Microsoft Style Guide
description: Provides a table that shows a history of recent updates to the Microsoft Writing Style Guide and outlines the date and changes made to various articles.
author: pallep
ms.author: pallep
-ms.date: 08/26/2024
+ms.date: 10/16/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
@@ -15,6 +15,9 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| October 16, 2024 | [quotation marks](https://learn.microsoft.com/en-us/style-guide/punctuation/quotation-marks) | Clarified guidance regarding default use of straight quotation marks and the Segoe font.
+| October 16, 2024 | [storage, storage space](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/storage-storage-device) | Changed topic title (previously storage, storage device). Updated guidance to use *storage space*.
+| October 16, 2024 | [disk space](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disk-space) | Updated guidance to recommend using storage or storage space; updated guidance to recommend use of drive in most cases that are not physical disks.
| August 26, 2024 | [Announcement] | The Microsoft Writing Style Guide has now aligned with Merriam-Webster as its dictionary of references. Links and mentions have been fixed globally.
| June 25, 2024 | [prompt, prompting](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/prompt) | Updated guidance to address new concerns about AI prompts and provide resources for prompt writing.
| May 9, 2024 | [Accessibility terms](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Added guidance to avoid the use of "special needs."
From 8cad31b30d36a827d71c927f5ea15e1ac4919a6c Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:25:11 -0500
Subject: [PATCH 481/486] Update disk-space.md
---
styleguide/a-z-word-list-term-collections/d/disk-space.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-space.md b/styleguide/a-z-word-list-term-collections/d/disk-space.md
index 42825c57..6a10e640 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-space.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-space.md
@@ -18,4 +18,4 @@ When referring to storage in a partition of space, mention it specifically and u
Storage in local drive (C:)
-**See also** [storage, storage device](~/a-z-word-list-term-collections/s/storage-storage-device.md)
+**See also** [storage, storage space](~/a-z-word-list-term-collections/s/storage-storage-device.md)
From 08c6966457cf5f03f9fb34cb290269834516e22a Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:25:44 -0500
Subject: [PATCH 482/486] Update disk-space.md
---
styleguide/a-z-word-list-term-collections/d/disk-space.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-space.md b/styleguide/a-z-word-list-term-collections/d/disk-space.md
index 6a10e640..aee4b596 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-space.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-space.md
@@ -1,6 +1,6 @@
---
title: disk space - Microsoft Style Guide
-description: In Microsoft documents, use 'disk space' instead of 'storage' or 'memory' to refer to available capacity on a disk.
+description: In Microsoft documents, use 'storage' or 'storage space' to refer to available capacity on a drive. Also, use 'drive' rather than 'disk.'
author: pallep
ms.author: pallep
ms.date: 10/16/2024
From 636c61c6ad335210dfc327a98d4f62a976635a71 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:26:29 -0500
Subject: [PATCH 483/486] Update disk-resource.md
---
.../a-z-word-list-term-collections/d/disk-resource.md | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/styleguide/a-z-word-list-term-collections/d/disk-resource.md b/styleguide/a-z-word-list-term-collections/d/disk-resource.md
index dfa1c86c..0cc19a64 100644
--- a/styleguide/a-z-word-list-term-collections/d/disk-resource.md
+++ b/styleguide/a-z-word-list-term-collections/d/disk-resource.md
@@ -1,13 +1,13 @@
---
-title: disk resource - Microsoft Style Guide
-description: In Microsoft documents, use 'disk resource' to refer to a disk or part of a disk shared on a server.
+title: drive resource - Microsoft Style Guide
+description: In Microsoft documents, use 'drive resource' to refer to a drive or part of a drive shared on a server.
author: pallep
ms.author: pallep
-ms.date: 01/19/2018
+ms.date: 10/16/2024
ms.topic: article
ms.service: microsoft-writing-style-guide
---
-# disk resource
+# drive resource
-Use to refer to a disk or part of a disk shared on a server.
+Use to refer to a drive or part of a drive shared on a server.
From 6c1d20af4e0e16fc5052a40ac22640ace5921da2 Mon Sep 17 00:00:00 2001
From: Senior Editor at Microsoft
<114177666+S-LRaillard@users.noreply.github.com>
Date: Wed, 16 Oct 2024 16:28:30 -0500
Subject: [PATCH 484/486] Update whats-new.md
---
styleguide/welcome/whats-new.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md
index ba24b06d..8e6a824b 100644
--- a/styleguide/welcome/whats-new.md
+++ b/styleguide/welcome/whats-new.md
@@ -15,6 +15,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui
| **Date** | **Article** | **Change** |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| October 16, 2024 | [drive resource](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disk-resource) | Renamed topic and altered guidance to *drive resource*.
| October 16, 2024 | [quotation marks](https://learn.microsoft.com/en-us/style-guide/punctuation/quotation-marks) | Clarified guidance regarding default use of straight quotation marks and the Segoe font.
| October 16, 2024 | [storage, storage space](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/storage-storage-device) | Changed topic title (previously storage, storage device). Updated guidance to use *storage space*.
| October 16, 2024 | [disk space](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disk-space) | Updated guidance to recommend using storage or storage space; updated guidance to recommend use of drive in most cases that are not physical disks.
From ef69c552c26a3a2520185c9c23748fec1866a29d Mon Sep 17 00:00:00 2001
From: nathlaroche <635965+nathlaroche@users.noreply.github.com>
Date: Wed, 30 Oct 2024 17:55:28 +0000
Subject: [PATCH 485/486] Initialize Docs repository:
https://github.com/MicrosoftDocs/microsoft-style-guide-pr of branch live
---
.openpublishing.publish.config.json | 12 ++++-----
SECURITY.md | 41 +++++++++++++++++++++++++++++
2 files changed, 46 insertions(+), 7 deletions(-)
create mode 100644 SECURITY.md
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
index acc9d1c5..7095b17f 100644
--- a/.openpublishing.publish.config.json
+++ b/.openpublishing.publish.config.json
@@ -25,9 +25,7 @@
"branches_to_filter": [],
"git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/microsoft-style-guide",
"git_repository_branch_open_to_public_contributors": "main",
- "skip_source_output_uploading": false,
"need_preview_pull_request": true,
- "contribution_branch_mappings": {},
"dependent_repositories": [
{
"path_to_root": "_themes",
@@ -48,13 +46,13 @@
"Pdf"
]
},
- "need_generate_pdf_url_template": true,
- "Targets": {
+ "targets": {
"Pdf": {
"template_folder": "_themes.pdf"
}
},
- "docs_build_engine": {
- "name": "docfx_v3"
- }
+ "docs_build_engine": {},
+ "skip_source_output_uploading": false,
+ "contribution_branch_mappings": {},
+ "need_generate_pdf_url_template": true
}
\ No newline at end of file
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 00000000..e138ec5d
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,41 @@
+
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc).
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+ * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+ * Full paths of source file(s) related to the manifestation of the issue
+ * The location of the affected source code (tag/branch/commit or direct URL)
+ * Any special configuration required to reproduce the issue
+ * Step-by-step instructions to reproduce the issue
+ * Proof-of-concept or exploit code (if possible)
+ * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+
From ee34b36dd261f50a4f1a88fb0bca09137014180e Mon Sep 17 00:00:00 2001
From: nathlaroche <635965+nathlaroche@users.noreply.github.com>
Date: Wed, 30 Oct 2024 17:55:43 +0000
Subject: [PATCH 486/486] Initialize Docs repository:
https://github.com/MicrosoftDocs/microsoft-style-guide-pr of branch live
---
.openpublishing.publish.config.json | 12 +++++
.../authorize.md | 1 +
writing-style-guide-msft-internal/docfx.json | 54 +++++++++++++++++++
3 files changed, 67 insertions(+)
create mode 100644 writing-style-guide-msft-internal/authorize.md
create mode 100644 writing-style-guide-msft-internal/docfx.json
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
index 7095b17f..c0ee8d2d 100644
--- a/.openpublishing.publish.config.json
+++ b/.openpublishing.publish.config.json
@@ -15,6 +15,18 @@
},
"build_entry_point": "docs",
"template_folder": "_themes"
+ },
+ {
+ "docset_name": "writing-style-guide-msft-internal",
+ "build_source_folder": "writing-style-guide-msft-internal",
+ "build_output_subfolder": "writing-style-guide-msft-internal",
+ "locale": "en-us",
+ "monikers": [],
+ "open_to_public_contributors": false,
+ "type_mapping": {
+ "Conceptual": "Content"
+ },
+ "build_entry_point": "docs"
}
],
"notification_subscribers": [],
diff --git a/writing-style-guide-msft-internal/authorize.md b/writing-style-guide-msft-internal/authorize.md
new file mode 100644
index 00000000..67f3185d
--- /dev/null
+++ b/writing-style-guide-msft-internal/authorize.md
@@ -0,0 +1 @@
+You are unauthorized to view the content
\ No newline at end of file
diff --git a/writing-style-guide-msft-internal/docfx.json b/writing-style-guide-msft-internal/docfx.json
new file mode 100644
index 00000000..64dd157f
--- /dev/null
+++ b/writing-style-guide-msft-internal/docfx.json
@@ -0,0 +1,54 @@
+{
+ "build": {
+ "content": [
+ {
+ "files": [
+ "**/*.md",
+ "**/*.yml"
+ ],
+ "exclude": [
+ "**/obj/**",
+ "**/includes/**",
+ "_themes/**",
+ "**/docfx.json",
+ "_repo.en-us/**",
+ "README.md",
+ "LICENSE",
+ "LICENSE-CODE",
+ "ThirdPartyNotices.md",
+ "SECURITY.md"
+ ]
+ }
+ ],
+ "resource": [
+ {
+ "files": [
+ "**/*.png",
+ "**/*.jpg"
+ ],
+ "exclude": [
+ "**/obj/**",
+ "**/includes/**",
+ "_themes/**",
+ "**/docfx.json",
+ "_repo.en-us/**"
+ ]
+ }
+ ],
+ "overwrite": [],
+ "externalReference": [],
+ "globalMetadata": {
+ "breadcrumb_path": "~/breadcrumb/writing-style-guide-msft-internal/toc.yml",
+ "feedback_system": "Standard",
+ "permissioned-type": "private",
+ "authorize_path": "~/authorize.md"
+ },
+ "fileMetadata": {
+ "permissioned-type": {
+ "**/toc.yml": "public",
+ "**/toc.md": "public"
+ }
+ },
+ "template": []
+ }
+}
\ No newline at end of file