diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json index 68517d562..c0ee8d2de 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": [], @@ -24,21 +36,19 @@ ], "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", - "skip_source_output_uploading": false, + "git_repository_branch_open_to_public_contributors": "main", "need_preview_pull_request": true, - "contribution_branch_mappings": {}, "dependent_repositories": [ { "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": {} } ], @@ -48,13 +58,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 000000000..e138ec5d6 --- /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). + + diff --git a/styleguide/TOC.md b/styleguide/TOC.md index c6e9965ae..361202e54 100644 --- a/styleguide/TOC.md +++ b/styleguide/TOC.md @@ -79,7 +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) ### [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) @@ -143,7 +142,7 @@ ### [chart](a-z-word-list-term-collections/c/chart.md) ### [chat](a-z-word-list-term-collections/c/chat.md) ### [chatbot](a-z-word-list-term-collections/c/chatbot.md) -### [check, check box, check mark](a-z-word-list-term-collections/c/check-check-box-check-mark.md) +### [check, checkbox, check mark](a-z-word-list-term-collections/c/check-checkbox-check-mark.md) ### [check in](a-z-word-list-term-collections/c/check-in.md) ### [child folder](a-z-word-list-term-collections/c/child-folder.md) ### [choose](a-z-word-list-term-collections/c/choose.md) @@ -187,6 +186,7 @@ ### [control-menu box](a-z-word-list-term-collections/c/control-menu-box.md) ### [conversation as a platform (CaaP)](a-z-word-list-term-collections/c/conversation-as-a-platform-caap.md) ### [conversational user interface (CUI)](a-z-word-list-term-collections/c/conversational-user-interface-cui.md) +### [Copilot, copilot](a-z-word-list-term-collections/c/Copilot-copilot.md) ### [-core](a-z-word-list-term-collections/c/dash-core.md) ### [corrupted](a-z-word-list-term-collections/c/corrupted.md) ### [country or region](a-z-word-list-term-collections/c/country-or-region.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/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) @@ -224,7 +225,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) @@ -245,7 +247,7 @@ ### [drill down, drill up, drill through](a-z-word-list-term-collections/d/drill-down-drill-up-drill-through.md) ### [drive](a-z-word-list-term-collections/d/drive.md) ### [drive name](a-z-word-list-term-collections/d/drive-name.md) -### [drop-down](a-z-word-list-term-collections/d/drop-down.md) +### [dropdown](a-z-word-list-term-collections/d/dropdown.md) ### [DVD](a-z-word-list-term-collections/d/dvd.md) ### [dynamic-link library (DLL)](a-z-word-list-term-collections/d/dynamic-link-library-dll.md) ### [dynamic service capacity](a-z-word-list-term-collections/d/dynamic-service-capacity.md) @@ -424,6 +426,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/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) @@ -439,6 +442,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 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) @@ -491,7 +496,7 @@ ### [management information systems](a-z-word-list-term-collections/m/management-information-systems.md) ### [manipulate](a-z-word-list-term-collections/m/manipulate.md) ### [marquee](a-z-word-list-term-collections/m/marquee.md) -### [master/slave, master/subordinate](a-z-word-list-term-collections/m/master-slave-master-subordinate.md) +### [master/slave](a-z-word-list-term-collections/m/master-slave.md) ### [mathematical](a-z-word-list-term-collections/m/mathematical.md) ### [matrix, matrices](a-z-word-list-term-collections/m/matrix-matrices.md) ### [Maximize button, maximize](a-z-word-list-term-collections/m/maximize-button-maximize.md) @@ -563,6 +568,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) @@ -607,7 +613,7 @@ ### [peripheral](a-z-word-list-term-collections/p/peripheral.md) ### [permissions](a-z-word-list-term-collections/p/permissions.md) ### [personal digital assistant](a-z-word-list-term-collections/p/personal-digital-assistant.md) -### [phone](a-z-word-list-term-collections/p/phone.md) +### [phone, phone number](a-z-word-list-term-collections/p/phone.md) ### [photo](a-z-word-list-term-collections/p/photo.md) ### [pin, unpin](a-z-word-list-term-collections/p/pin-unpin.md) ### [pinch](a-z-word-list-term-collections/p/pinch.md) @@ -642,7 +648,7 @@ ### [profile](a-z-word-list-term-collections/p/profile.md) ### [program](a-z-word-list-term-collections/p/program.md) ### [program file](a-z-word-list-term-collections/p/program-file.md) -### [prompt](a-z-word-list-term-collections/p/prompt.md) +### [prompt, prompting](a-z-word-list-term-collections/p/prompt.md) ### [prop](a-z-word-list-term-collections/p/prop.md) ### [property](a-z-word-list-term-collections/p/property.md) ### [property sheet, property page](a-z-word-list-term-collections/p/property-sheet-property-page.md) @@ -706,6 +712,7 @@ ### [search, search and replace](a-z-word-list-term-collections/s/search-and-replace.md) ### [search box](a-z-word-list-term-collections/s/search-box.md) ### [secondary menu](a-z-word-list-term-collections/s/secondary-menu.md) +### [see, see also, and similar phrases](a-z-word-list-term-collections/s/see-see-also-and-similar-phrases.md) ### [select](a-z-word-list-term-collections/s/select.md) ### [server](a-z-word-list-term-collections/s/server.md) ### [service-level agreement (SLA)](a-z-word-list-term-collections/s/service-level-agreement-sla.md) @@ -732,6 +739,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/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) @@ -798,6 +806,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) @@ -856,6 +865,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) @@ -867,7 +877,7 @@ ### [wildcard character](a-z-word-list-term-collections/w/wildcard-character.md) ### [window](a-z-word-list-term-collections/w/window.md) ### [Windows, Windows-based](a-z-word-list-term-collections/w/windows-windows-based.md) -### [Windows 7, Windows 8, Windows 10](a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md) +### [Windows 10, Windows 11](a-z-word-list-term-collections/w/windows-10-windows-11.md) ### [Windows Explorer](a-z-word-list-term-collections/w/windows-explorer.md) ### [wireframe](a-z-word-list-term-collections/w/wireframe.md) ### [wireless](a-z-word-list-term-collections/w/wireless.md) @@ -879,6 +889,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) @@ -902,6 +913,7 @@ ## [Graphics, design, and media](accessibility/graphics-design-media.md) # [Acronyms](acronyms.md) # [Bias-free communication](bias-free-communication.md) +## [Militaristic language](militaristic-language.md) # [Capitalization](capitalization.md) # [Chatbots and virtual agents](chatbots-virtual-agents/index.md) ## [Structural and technical considerations](chatbots-virtual-agents/structural-technical-considerations.md) @@ -935,7 +947,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) 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 0ee3a24db..215b6f3ab 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 cc835bd60..b11836b44 100644 --- a/styleguide/a-z-word-list-term-collections/a/above.md +++ b/styleguide/a-z-word-list-term-collections/a/above.md @@ -1,17 +1,18 @@ --- -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 +ms.date: 01/19/2019 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# above +# Above Don't use to mean *earlier*. -Don't use as an adjective preceding a noun (*the above section*) or following a noun (*the code above*). Use a hyperlink, or use *previous, preceding,* or *earlier.* +Don't use as an adjective preceding a noun (*the above section*) or following a noun (*the code above*). Use a link, or use *previous, preceding,* or *earlier.* **Examples** Use the preceding code to display information about the database. 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 09300f879..30a49cb5d 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,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 b515b2ae7..3e1447c1f 100644 --- a/styleguide/a-z-word-list-term-collections/a/access.md +++ b/styleguide/a-z-word-list-term-collections/a/access.md @@ -1,13 +1,14 @@ --- -title: access - Microsoft Style Guide +title: Access - Microsoft Style Guide +description: This article outlines the use of the word access per Microsoft style guidelines. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 11e697e54..1b94ef966 100644 --- a/styleguide/a-z-word-list-term-collections/a/accessible.md +++ b/styleguide/a-z-word-list-term-collections/a/accessible.md @@ -1,13 +1,14 @@ --- -title: accessible - Microsoft Style Guide +title: Accessible - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 678f0900f..9822dc6c9 100644 --- a/styleguide/a-z-word-list-term-collections/a/achievement.md +++ b/styleguide/a-z-word-list-term-collections/a/achievement.md @@ -1,16 +1,16 @@ --- -title: achievement - Microsoft Style Guide +title: Achievement - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 883ace519..e1a1cd807 100644 --- a/styleguide/a-z-word-list-term-collections/a/actionable.md +++ b/styleguide/a-z-word-list-term-collections/a/actionable.md @@ -1,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 a32523ee8..34d4d3a35 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 64417c832..6050fbb6f 100644 --- a/styleguide/a-z-word-list-term-collections/a/adapter.md +++ b/styleguide/a-z-word-list-term-collections/a/adapter.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# adapter +# Adapter **See** [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md) 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 b2ec1e0ad..3c5ddff9b 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 cdec74d39..2988bb882 100644 --- a/styleguide/a-z-word-list-term-collections/a/add.md +++ b/styleguide/a-z-word-list-term-collections/a/add.md @@ -1,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 2fd7fc40b..a7d96b8f9 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 cb7d59e38..46010860b 100644 --- a/styleguide/a-z-word-list-term-collections/a/administer.md +++ b/styleguide/a-z-word-list-term-collections/a/administer.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# administer +# Administer Use instead of *administrate*. diff --git a/styleguide/a-z-word-list-term-collections/a/administrator-admin.md b/styleguide/a-z-word-list-term-collections/a/administrator-admin.md index 87986a5bd..6e9641630 100644 --- a/styleguide/a-z-word-list-term-collections/a/administrator-admin.md +++ b/styleguide/a-z-word-list-term-collections/a/administrator-admin.md @@ -4,7 +4,7 @@ author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # administrator, admin 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 95761f8c7..5b3f4b4de 100644 --- a/styleguide/a-z-word-list-term-collections/a/afterward.md +++ b/styleguide/a-z-word-list-term-collections/a/afterward.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # afterward 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 7a27e6bbf..b92b7639f 100644 --- a/styleguide/a-z-word-list-term-collections/a/against.md +++ b/styleguide/a-z-word-list-term-collections/a/against.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # against 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 ca52414ec..51d9a6253 100644 --- a/styleguide/a-z-word-list-term-collections/a/alarm.md +++ b/styleguide/a-z-word-list-term-collections/a/alarm.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # alarm 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 033736dba..707f4344f 100644 --- a/styleguide/a-z-word-list-term-collections/a/alert.md +++ b/styleguide/a-z-word-list-term-collections/a/alert.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # alert 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 e08b10c4d..85ac774ce 100644 --- a/styleguide/a-z-word-list-term-collections/a/alias.md +++ b/styleguide/a-z-word-list-term-collections/a/alias.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # alias 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 f82edb0af..50e55ecf2 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # allow, allows 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 fd128403d..3cf45f83f 100644 --- a/styleguide/a-z-word-list-term-collections/a/alphabetical.md +++ b/styleguide/a-z-word-list-term-collections/a/alphabetical.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # alphabetical 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 4d59a924e..14301a795 100644 --- a/styleguide/a-z-word-list-term-collections/a/alphanumeric.md +++ b/styleguide/a-z-word-list-term-collections/a/alphanumeric.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # alphanumeric 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 d67881065..a8b636b1c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # AM, PM 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 16da8759b..b76dbb754 100644 --- a/styleguide/a-z-word-list-term-collections/a/ampersand.md +++ b/styleguide/a-z-word-list-term-collections/a/ampersand.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ampersand (&) 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 25b820273..4a05baaf7 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # and/or 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 0a6a44b9e..ebff2b980 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # and so on 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 bb3fc1ce1..2e844bb87 100644 --- a/styleguide/a-z-word-list-term-collections/a/antialiasing.md +++ b/styleguide/a-z-word-list-term-collections/a/antialiasing.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # antialiasing 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 a83bd86da..49a52739c 100644 --- a/styleguide/a-z-word-list-term-collections/a/antimalware.md +++ b/styleguide/a-z-word-list-term-collections/a/antimalware.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # antimalware 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 820e25f17..115ee5bc6 100644 --- a/styleguide/a-z-word-list-term-collections/a/antispyware.md +++ b/styleguide/a-z-word-list-term-collections/a/antispyware.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # antispyware 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 8680c010a..0cc005aec 100644 --- a/styleguide/a-z-word-list-term-collections/a/antivirus.md +++ b/styleguide/a-z-word-list-term-collections/a/antivirus.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # antivirus 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 b806bf4d9..c10d75988 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # app, application 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 ba9ac96db..06b23030c 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # appendix, appendices 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 8d18d078e..3c8047376 100644 --- a/styleguide/a-z-word-list-term-collections/a/applet.md +++ b/styleguide/a-z-word-list-term-collections/a/applet.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # applet 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 78e2c3869..0b4c41d05 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # application developer, app developer 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 4b47a7862..5aa932135 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # application file, app file 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 4ccffdfc1..812cccaa4 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # application icon, app icon 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 064321560..dafc98121 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # application window, app window 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 9255a480f..893e3a111 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # argument vs. parameter 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 554fa3424..d8f018cb3 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # arrow keys 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 47308ef4b..41d657546 100644 --- a/styleguide/a-z-word-list-term-collections/a/arrow.md +++ b/styleguide/a-z-word-list-term-collections/a/arrow.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # arrow 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 900fb6016..42af7bade 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # AI (artificial intelligence) 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 d903c12c1..914b17b4c 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # as well as 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 8900f376c..494c56f08 100644 --- a/styleguide/a-z-word-list-term-collections/a/ask.md +++ b/styleguide/a-z-word-list-term-collections/a/ask.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ask 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 ef76fff43..0c5f683c5 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # assembly language 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 b09d16625..67285a43a 100644 --- a/styleguide/a-z-word-list-term-collections/a/assistive.md +++ b/styleguide/a-z-word-list-term-collections/a/assistive.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # assistive 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 5466e5626..ba8e79f61 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # assure, ensure, insure 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 1b617b9c4..5a4acecd9 100644 --- a/styleguide/a-z-word-list-term-collections/a/asterisk.md +++ b/styleguide/a-z-word-list-term-collections/a/asterisk.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # asterisk (\*) 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 05d43d785..66bc2ab30 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # at sign (@) 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 b676f7ffd..aade9b655 100644 --- a/styleguide/a-z-word-list-term-collections/a/attribute.md +++ b/styleguide/a-z-word-list-term-collections/a/attribute.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # attribute 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 3be3e78ab..674c10d6d 100644 --- a/styleguide/a-z-word-list-term-collections/a/audiobook.md +++ b/styleguide/a-z-word-list-term-collections/a/audiobook.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # audiobook 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 18dfb83c8..df48b11dd 100644 --- a/styleguide/a-z-word-list-term-collections/a/author.md +++ b/styleguide/a-z-word-list-term-collections/a/author.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # author 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 0e4b2f6b5..4c9508bd2 100644 --- a/styleguide/a-z-word-list-term-collections/a/auto.md +++ b/styleguide/a-z-word-list-term-collections/a/auto.md @@ -1,15 +1,16 @@ --- -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 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +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-.* 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 6d5be95ad..9988538a8 100644 --- a/styleguide/a-z-word-list-term-collections/a/avg.md +++ b/styleguide/a-z-word-list-term-collections/a/avg.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product specific +ms.service: microsoft-writing-style-guide --- # avg 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 8b65e8433..f8242be47 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 8fd81ca67..0f531b13b 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,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 570966bfd..a0a51bbe3 100644 --- a/styleguide/a-z-word-list-term-collections/b/backbone.md +++ b/styleguide/a-z-word-list-term-collections/b/backbone.md @@ -1,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 5eae7c5b1..d854f69ea 100644 --- a/styleguide/a-z-word-list-term-collections/b/backlight.md +++ b/styleguide/a-z-word-list-term-collections/b/backlight.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 2d3fef382..4d15c3f5a 100644 --- a/styleguide/a-z-word-list-term-collections/b/backspace.md +++ b/styleguide/a-z-word-list-term-collections/b/backspace.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 bcf422f60..7a99d33b8 100644 --- a/styleguide/a-z-word-list-term-collections/b/backtab.md +++ b/styleguide/a-z-word-list-term-collections/b/backtab.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 1cddcce35..3fb8aab50 100644 --- a/styleguide/a-z-word-list-term-collections/b/badge.md +++ b/styleguide/a-z-word-list-term-collections/b/badge.md @@ -1,16 +1,16 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 5af5e10e3..7c79beb89 100644 --- a/styleguide/a-z-word-list-term-collections/b/baseline.md +++ b/styleguide/a-z-word-list-term-collections/b/baseline.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 361623b6b..79fe146cf 100644 --- a/styleguide/a-z-word-list-term-collections/b/baud.md +++ b/styleguide/a-z-word-list-term-collections/b/baud.md @@ -1,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 0f129356c..2e215ca33 100644 --- a/styleguide/a-z-word-list-term-collections/b/beep.md +++ b/styleguide/a-z-word-list-term-collections/b/beep.md @@ -1,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 9b18de1dc..c27f5208e 100644 --- a/styleguide/a-z-word-list-term-collections/b/below.md +++ b/styleguide/a-z-word-list-term-collections/b/below.md @@ -1,17 +1,18 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# below +# Below Don't use to mean *later*. -Don't use as an adjective preceding a noun (*the below section*) or following a noun (*the code below*). Use a hyperlink, or use *later* or *the* *following*. +Don't use as an adjective preceding a noun (*the below section*) or following a noun (*the code below*). Use a link, or use *later* or *the* *following*. **Examples** Use the following code to display information about the database. 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 f58d05729..1380cdf4a 100644 --- a/styleguide/a-z-word-list-term-collections/b/beta.md +++ b/styleguide/a-z-word-list-term-collections/b/beta.md @@ -1,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # beta 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 f1a2878e2..5d9c684d9 100644 --- a/styleguide/a-z-word-list-term-collections/b/bi.md +++ b/styleguide/a-z-word-list-term-collections/b/bi.md @@ -1,14 +1,15 @@ --- -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 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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/). +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). 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 a75ea9a2e..896d90a47 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # big data 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 563b6cf18..2abf01a1a 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,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 af78fb76a..b0f017493 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,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 6cd4ae70c..1c68d9494 100644 --- a/styleguide/a-z-word-list-term-collections/b/bio.md +++ b/styleguide/a-z-word-list-term-collections/b/bio.md @@ -1,17 +1,18 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 8a6496eb7..b8c553a21 100644 --- a/styleguide/a-z-word-list-term-collections/b/bitmap.md +++ b/styleguide/a-z-word-list-term-collections/b/bitmap.md @@ -1,13 +1,14 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 6096914dc..690298880 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,10 +1,11 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bits per second 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 9b552a7f0..077d40d38 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,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 4b51d352d..f9663fc8e 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,12 +1,13 @@ --- -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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# black hat hacker +# Black Hat Hacker See [Security term collection](~/a-z-word-list-term-collections/term-collections/security-terms.md) diff --git a/styleguide/a-z-word-list-term-collections/b/blacklist.md b/styleguide/a-z-word-list-term-collections/b/blacklist.md index 0c46f7505..54e9ddc7c 100644 --- a/styleguide/a-z-word-list-term-collections/b/blacklist.md +++ b/styleguide/a-z-word-list-term-collections/b/blacklist.md @@ -1,17 +1,18 @@ --- title: blacklist - Microsoft Style Guide +description: Describes the term blacklist, how the term blocklist will be used in its place, and provides examples of using the term blocklist in content. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 01/15/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # blacklist -Consider alternatives where possible. +Never use *blacklist*. Use *blocklist* instead. +For more specific usage, *blocked senders list* can be used. **Examples** -Blocked Senders list -Safe Recipients list -blocked or safe programs +*Blocklists* can help prevent unwanted spam. +It could be useful to have a *blocked senders list*. 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 6fdafa128..34e3872f5 100644 --- a/styleguide/a-z-word-list-term-collections/b/blade.md +++ b/styleguide/a-z-word-list-term-collections/b/blade.md @@ -1,15 +1,16 @@ --- 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 +ms.date: 11/02/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # blade -Use *blade* to refer to a pane in the Azure portal. Avoid talking about blades. Instead, try to discuss what the customer needs to do. +Avoid talking about UI elements and instead try to discuss what the customer needs to do. If you have to refer to a pane in the Azure portal, use *blade*. When you must mention a blade: 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 1938cd4a1..ec51657bd 100644 --- a/styleguide/a-z-word-list-term-collections/b/blank.md +++ b/styleguide/a-z-word-list-term-collections/b/blank.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # blank 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 f3ecef727..a032efa81 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # blog, blogger, blogroll, weblog 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 d3eb263c8..15a46c05c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Blu-ray Disc 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 0131c7aaa..e6dc3e7bd 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # blue screen, bluescreen 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 97b0cdf17..5275a542d 100644 --- a/styleguide/a-z-word-list-term-collections/b/bluetooth.md +++ b/styleguide/a-z-word-list-term-collections/b/bluetooth.md @@ -1,12 +1,13 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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. 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 d390154e5..8f36ade31 100644 --- a/styleguide/a-z-word-list-term-collections/b/board.md +++ b/styleguide/a-z-word-list-term-collections/b/board.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # board 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 765236a70..008d7878c 100644 --- a/styleguide/a-z-word-list-term-collections/b/bold.md +++ b/styleguide/a-z-word-list-term-collections/b/bold.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bold 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 68571b595..000372815 100644 --- a/styleguide/a-z-word-list-term-collections/b/bookmark.md +++ b/styleguide/a-z-word-list-term-collections/b/bookmark.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bookmark 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 b5534fa53..39ada0aec 100644 --- a/styleguide/a-z-word-list-term-collections/b/boolean.md +++ b/styleguide/a-z-word-list-term-collections/b/boolean.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Boolean 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 0dae9b4e8..5d5dc7f37 100644 --- a/styleguide/a-z-word-list-term-collections/b/boot.md +++ b/styleguide/a-z-word-list-term-collections/b/boot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # boot 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 46c790c07..f7e29d7da 100644 --- a/styleguide/a-z-word-list-term-collections/b/bot.md +++ b/styleguide/a-z-word-list-term-collections/b/bot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bot 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 aefcaa04e..6c17c7821 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bottom left, bottom right 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 32fef4b93..acb08392b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bounding outline 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 c948619ee..176ae3a9d 100644 --- a/styleguide/a-z-word-list-term-collections/b/box.md +++ b/styleguide/a-z-word-list-term-collections/b/box.md @@ -1,22 +1,23 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # box Most of the time, avoid talking about UI elements. -When you need to refer to dialog box elements by name, use *box* instead of *field* to refer to any box except a check box or a list box. For a check box, use the complete term, *check box*. For an element that displays a list, such as a drop-down list box, use *list* instead of *box* for clarity. +When you need to refer to dialog box elements by name, use *box* instead of *field* to refer to any box except a checkbox or a list box. For a checkbox, use the complete term, *checkbox*. For an element that displays a list, such as a dropdown list box, use *list* instead of *box* for clarity. **Examples** the **Read-Only** box the **File Name** box -the **Hidden Text** check box +the **Hidden Text** checkbox the **Wallpaper** list Don't use *box* as a synonym for client and server hardware. 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 57bf63835..a0be2f224 100644 --- a/styleguide/a-z-word-list-term-collections/b/bps.md +++ b/styleguide/a-z-word-list-term-collections/b/bps.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bps 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 ba76542f2..3cff2bd5a 100644 --- a/styleguide/a-z-word-list-term-collections/b/breakpoint.md +++ b/styleguide/a-z-word-list-term-collections/b/breakpoint.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # breakpoint 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 33bdbe856..24cb8dcdb 100644 --- a/styleguide/a-z-word-list-term-collections/b/broadcast.md +++ b/styleguide/a-z-word-list-term-collections/b/broadcast.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # broadcast 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 bd5ed9fc2..79f1f44b5 100644 --- a/styleguide/a-z-word-list-term-collections/b/browse.md +++ b/styleguide/a-z-word-list-term-collections/b/browse.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # browse 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 01a63d0d3..4dac009ba 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bug fix 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 2c4dd5b04..62f557ab5 100644 --- a/styleguide/a-z-word-list-term-collections/b/build.md +++ b/styleguide/a-z-word-list-term-collections/b/build.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # build 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 70d3e1dce..56bcd9b5f 100644 --- a/styleguide/a-z-word-list-term-collections/b/bulk.md +++ b/styleguide/a-z-word-list-term-collections/b/bulk.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # bulk 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 1cb94d919..506fe95ad 100644 --- a/styleguide/a-z-word-list-term-collections/b/button.md +++ b/styleguide/a-z-word-list-term-collections/b/button.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # button 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 275674f47..8cdca43f4 100644 --- a/styleguide/a-z-word-list-term-collections/b/by.md +++ b/styleguide/a-z-word-list-term-collections/b/by.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # by (publisher or company name) diff --git a/styleguide/a-z-word-list-term-collections/c/Copilot-copilot.md b/styleguide/a-z-word-list-term-collections/c/Copilot-copilot.md new file mode 100644 index 000000000..8705fc9cc --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/c/Copilot-copilot.md @@ -0,0 +1,31 @@ +--- +title: Copilot, copilot - Microsoft Style Guide +description: This topic describes the difference between Microsoft Copilot and generic third-party copilots, and how to refer to the two. +author: pallep +ms.author: pallep +ms.date: 04/19/2024 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# Copilot, copilot + +The term *copilot* can be used in a general sense to describe any AI-powered assistant or helper. *Microsoft Copilot* is our first-party tool that uses the power of AI to understand natural language prompts and perform a variety of tasks such as generating content, summarizing information, and organizing data. + +**Microsoft Copilot experiences** + +On first mention, use *Microsoft Copilot*. For subsequent mentions, it’s OK to use *Copilot*. +When using *Copilot* to describe a Microsoft experience, don’t make *Copilot* plural, but you may use it as an adjective describing a plural noun (for example, "Copilot experiences"). Don’t use an article (*a/the*) in front of names that include *Copilot*. Don't use *Copilot/copilot* as a verb. + +**Custom copilot experiences** + +Use a lowercase c when referring to a copilot other than Microsoft Copilot, such as a third-party experience created in Copilot Studio that responds to natural language prompts and uses generative AI to help customers complete tasks. + +It’s OK to use *copilots* in the plural to describe these third-party experiences. When you use *copilot* as a noun or adjective to refer generally to third-party experiences, it should be lowercase. It’s OK to use the article *a* with copilot, but not *the*.  + +**Examples** +Turn your words into a powerful productivity tool with copilot assistance.  + +When generating summaries about your document, Copilot will provide references with citations. + +Create AI-powered copilots using Microsoft Copilot Studio. 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 deba16277..1574f3324 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # C, C++, C\# 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 a9883067a..0dd55e1f0 100644 --- a/styleguide/a-z-word-list-term-collections/c/cable.md +++ b/styleguide/a-z-word-list-term-collections/c/cable.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cable 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 e2d19005c..bce577cb5 100644 --- a/styleguide/a-z-word-list-term-collections/c/cabling.md +++ b/styleguide/a-z-word-list-term-collections/c/cabling.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cabling 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 c6e039158..8a4ad45ff 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cache vs. disk cache 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 922411d80..89f40e10e 100644 --- a/styleguide/a-z-word-list-term-collections/c/calendar.md +++ b/styleguide/a-z-word-list-term-collections/c/calendar.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # calendar 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 754ff7aad..3c1502116 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # call back, callback 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 ff7e30c7c..41423d4da 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # call out, callout 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 cb82e821e..47ef5122d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # can, may 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 13ef908fa..ed059aaf9 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,15 +1,16 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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. 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 f8a912cdc..5f30eb695 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # carry out vs. run 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 9c3d0450b..746d97bc6 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Cascading Style Sheets (CSS) 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 06959d942..b6bd321e9 100644 --- a/styleguide/a-z-word-list-term-collections/c/catalog.md +++ b/styleguide/a-z-word-list-term-collections/c/catalog.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # catalog 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 a8abc28de..f07cfd91f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # category axis 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 d75c268ea..54f96b424 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cell phone, cellular phone 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 bcf47b3c1..d8b9426c6 100644 --- a/styleguide/a-z-word-list-term-collections/c/cellular.md +++ b/styleguide/a-z-word-list-term-collections/c/cellular.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cellular 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 44459e1c7..e8bf802bf 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # center on 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 bc2693898..aa5a6bb6d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # character set 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 3ed0a9124..095db10aa 100644 --- a/styleguide/a-z-word-list-term-collections/c/chart.md +++ b/styleguide/a-z-word-list-term-collections/c/chart.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # chart 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 4380b4eb2..4b592c42e 100644 --- a/styleguide/a-z-word-list-term-collections/c/chat.md +++ b/styleguide/a-z-word-list-term-collections/c/chat.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # chat 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 84cc7c33d..cb9d9cd71 100644 --- a/styleguide/a-z-word-list-term-collections/c/chatbot.md +++ b/styleguide/a-z-word-list-term-collections/c/chatbot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # chatbot diff --git a/styleguide/a-z-word-list-term-collections/c/check-check-box-check-mark.md b/styleguide/a-z-word-list-term-collections/c/check-check-box-check-mark.md deleted file mode 100644 index 2e1299ca3..000000000 --- a/styleguide/a-z-word-list-term-collections/c/check-check-box-check-mark.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: check, check box, check mark - Microsoft Style Guide -author: pallep -ms.author: pallep -ms.date: 01/19/2018 -ms.topic: article -ms.prod: non-product-specific ---- - -# check, check box, check mark - -Use *check* or *checked* as an adjective related to check boxes. For example, *a check mark* or *a checked command*. - -Use *check box,* not *box* or *checkbox,* to refer to a check box in UI. - -Use *select* and *clear* with check boxes, not *turn on* and *turn off,* *mark* and *unmark,* *check* and *uncheck,* or *select* and *deselect.* - -Use *check mark,* not *check,* as a noun. - -**See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) 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 new file mode 100644 index 000000000..c68bf8987 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/c/check-checkbox-check-mark.md @@ -0,0 +1,19 @@ +--- +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 documents. +author: pallep +ms.author: pallep +ms.date: 11/02/2023 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# check, checkbox, check mark + +Use *check mark* to refer to a mark placed next to an item to show it’s selected. + +Use *checkbox*, not *box* or *check box*, to refer to a checkbox in UI. Avoid talking about UI elements. Instead, discuss what the customer needs to do or what they're looking at. + +Use *select* and *clear* with checkboxes, not *turn on* and *turn off,* *mark* and *unmark,* *check* and *uncheck,* or *select* and *deselect.* + +**See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) 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 a5bf029fd..43baed137 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # check in 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 a38c36246..8b66be9df 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # child folder 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 38d94c8cb..c52d5b6ef 100644 --- a/styleguide/a-z-word-list-term-collections/c/choose.md +++ b/styleguide/a-z-word-list-term-collections/c/choose.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # choose 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 c479741d9..8dab78558 100644 --- a/styleguide/a-z-word-list-term-collections/c/clear.md +++ b/styleguide/a-z-word-list-term-collections/c/clear.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # clear 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 efdf9b0c4..d127f9d8a 100644 --- a/styleguide/a-z-word-list-term-collections/c/click.md +++ b/styleguide/a-z-word-list-term-collections/c/click.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # click 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 5d461fdc8..befdcf3e5 100644 --- a/styleguide/a-z-word-list-term-collections/c/clickstream.md +++ b/styleguide/a-z-word-list-term-collections/c/clickstream.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # clickstream 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 b5714a74e..a8473849a 100644 --- a/styleguide/a-z-word-list-term-collections/c/clickthrough.md +++ b/styleguide/a-z-word-list-term-collections/c/clickthrough.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # clickthrough 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 045cc30dd..83b41f2f4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # client/server 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 6e4df896b..e6d828a56 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # client side, client-side 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 e4d605cd9..5accc0c7c 100644 --- a/styleguide/a-z-word-list-term-collections/c/client.md +++ b/styleguide/a-z-word-list-term-collections/c/client.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # client 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 cc9118ca1..0e2a9b607 100644 --- a/styleguide/a-z-word-list-term-collections/c/clipboard.md +++ b/styleguide/a-z-word-list-term-collections/c/clipboard.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # clipboard diff --git a/styleguide/a-z-word-list-term-collections/c/close-button.md b/styleguide/a-z-word-list-term-collections/c/close-button.md index 54e00e213..29532f4fd 100644 --- a/styleguide/a-z-word-list-term-collections/c/close-button.md +++ b/styleguide/a-z-word-list-term-collections/c/close-button.md @@ -1,10 +1,11 @@ --- title: Close button - Microsoft Style Guide +description: Describes the use of the Close button when referred to in content and provides examples when using referring to the Close button in content. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Close button @@ -12,7 +13,7 @@ ms.prod: non-product-specific Spell out and capitalize the word *Close*. It's OK to use *the* ***Close*** *button* to eliminate ambiguity in content that teaches beginning skills, but for general audiences, just use ***Close***. Use bold for ***Close*** when you're talking about the **Close** button. If you can, use an inline graphic of the button. **Examples** -Select the **Close** button ![](media/close-button/1581618122.png). -Select **Close** ![](media/close-button/518967462.png). +Select the **Close** button :::image type="icon" source="media/close-button/1581618122.png":::. +Select **Close** :::image type="icon" source="media/close-button/1581618122.png":::. **See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) 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 1a5dfbe65..19d097f8f 100644 --- a/styleguide/a-z-word-list-term-collections/c/close.md +++ b/styleguide/a-z-word-list-term-collections/c/close.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # close 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 88d848121..333e857ed 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cloud platform 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 f3ee2c032..113035aa4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cloud services 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 17b13b66c..47e43f024 100644 --- a/styleguide/a-z-word-list-term-collections/c/cloud.md +++ b/styleguide/a-z-word-list-term-collections/c/cloud.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cloud 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 fc20fa1cc..a3d564332 100644 --- a/styleguide/a-z-word-list-term-collections/c/co.md +++ b/styleguide/a-z-word-list-term-collections/c/co.md @@ -1,14 +1,15 @@ --- 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.prod: non-product-specific +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). 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 efee44a16..a872785d8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # code page 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 94a900df7..c22653103 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # code point diff --git a/styleguide/a-z-word-list-term-collections/c/codec.md b/styleguide/a-z-word-list-term-collections/c/codec.md index 1e48a82ec..1ea573793 100644 --- a/styleguide/a-z-word-list-term-collections/c/codec.md +++ b/styleguide/a-z-word-list-term-collections/c/codec.md @@ -4,7 +4,7 @@ author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # codec 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 35b06e9e5..3fb244533 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # color map 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 a5f358248..0fd47bba3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # column format 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 5d1c090ee..f225d0915 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # combo box 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 e6173db53..5201297b1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # command button 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 16f6f57b2..2565d2c54 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # command line, command-line 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 e8068ecb3..d958fdc87 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # command prompt 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 3569bc7c1..0ef8e2228 100644 --- a/styleguide/a-z-word-list-term-collections/c/command.md +++ b/styleguide/a-z-word-list-term-collections/c/command.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # command 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 7f9c654d6..525ad48c1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # community cloud 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 2b523980c..f59e05e3c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # company vs. organization 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 ccbb414a1..79f1cc6ae 100644 --- a/styleguide/a-z-word-list-term-collections/c/compile.md +++ b/styleguide/a-z-word-list-term-collections/c/compile.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # compile 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 24b43301a..e618b3551 100644 --- a/styleguide/a-z-word-list-term-collections/c/compute.md +++ b/styleguide/a-z-word-list-term-collections/c/compute.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # compute 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 2836da58a..dcc93a8a0 100644 --- a/styleguide/a-z-word-list-term-collections/c/computer.md +++ b/styleguide/a-z-word-list-term-collections/c/computer.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # computer 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 a33057b97..5603974a2 100644 --- a/styleguide/a-z-word-list-term-collections/c/connect.md +++ b/styleguide/a-z-word-list-term-collections/c/connect.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # connect 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 a78c05042..0444e6341 100644 --- a/styleguide/a-z-word-list-term-collections/c/console.md +++ b/styleguide/a-z-word-list-term-collections/c/console.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # console diff --git a/styleguide/a-z-word-list-term-collections/c/context-menu.md b/styleguide/a-z-word-list-term-collections/c/context-menu.md index 8b610b2cd..c9b7075d7 100644 --- a/styleguide/a-z-word-list-term-collections/c/context-menu.md +++ b/styleguide/a-z-word-list-term-collections/c/context-menu.md @@ -4,7 +4,7 @@ author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # context menu 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 862f37aa6..5f8990998 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # context-sensitive 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 bbf3fbff6..112fa6185 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # contiguous selection diff --git a/styleguide/a-z-word-list-term-collections/c/control-menu-box.md b/styleguide/a-z-word-list-term-collections/c/control-menu-box.md index 5e22d7b5e..01060d58c 100644 --- a/styleguide/a-z-word-list-term-collections/c/control-menu-box.md +++ b/styleguide/a-z-word-list-term-collections/c/control-menu-box.md @@ -1,14 +1,15 @@ --- title: control-menu box - Microsoft Style Guide +description: Describes the shortcut menu that appears in title bars and informs content developers to avoid referring to this shortcut menu by name. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # control-menu box Avoid referring by name to this icon and the menu that it opens. If you must, refer to the *\ icon* or the *\ shortcut menu*. -![](media/control-menu-box/1955337661.PNG) +![Screenshot of the shortcut menu which contains various icons that can be selected, including undo and redo options.](media/control-menu-box/1955337661.PNG) 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 e637b929e..4184c1b73 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Control Panel 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 1c735077f..20f345700 100644 --- a/styleguide/a-z-word-list-term-collections/c/control.md +++ b/styleguide/a-z-word-list-term-collections/c/control.md @@ -1,15 +1,16 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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*. 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 6e3cdea41..443657f74 100644 --- a/styleguide/a-z-word-list-term-collections/c/controller.md +++ b/styleguide/a-z-word-list-term-collections/c/controller.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # controller 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 d86440313..008a21915 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # conversation as a platform (CaaP) 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 8fe45caec..903934c90 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # conversational user interface (CUI) 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 821a776a2..ecb2e392a 100644 --- a/styleguide/a-z-word-list-term-collections/c/corrupted.md +++ b/styleguide/a-z-word-list-term-collections/c/corrupted.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # corrupted 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 56e023324..e0faa7312 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # country or region 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 c3dedac32..121f979d5 100644 --- a/styleguide/a-z-word-list-term-collections/c/crash.md +++ b/styleguide/a-z-word-list-term-collections/c/crash.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # crash 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 200eaec95..b8ea58100 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cut, cut-and-paste 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 fcb222cad..a6a7c6895 100644 --- a/styleguide/a-z-word-list-term-collections/c/cyber.md +++ b/styleguide/a-z-word-list-term-collections/c/cyber.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # cyber- 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 600cbe4e2..6c4921ccc 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # \-core 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 000000000..c2a90c6a0 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/d/dark-mode.md @@ -0,0 +1,20 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# 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. 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 6ce743ea0..b7faae394 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # data binding 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 bf24104de..0aca97878 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # data, datum 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 8770fff67..131202380 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # data record 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 751e8544d..e2ff4b02b 100644 --- a/styleguide/a-z-word-list-term-collections/d/database.md +++ b/styleguide/a-z-word-list-term-collections/d/database.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # database 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 f4f0ae8b1..c0b8451bd 100644 --- a/styleguide/a-z-word-list-term-collections/d/datacenter.md +++ b/styleguide/a-z-word-list-term-collections/d/datacenter.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # datacenter 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 e948da662..5b796b463 100644 --- a/styleguide/a-z-word-list-term-collections/d/datagram.md +++ b/styleguide/a-z-word-list-term-collections/d/datagram.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # datagram 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 332709a97..bb171a9c5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # deaf or hard-of-hearing 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 a1e1541f1..433aeb528 100644 --- a/styleguide/a-z-word-list-term-collections/d/debug.md +++ b/styleguide/a-z-word-list-term-collections/d/debug.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # debug 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 de671560f..cdb263178 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # deceptive software 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 c6ac0c0e7..87b34dc22 100644 --- a/styleguide/a-z-word-list-term-collections/d/decrement.md +++ b/styleguide/a-z-word-list-term-collections/d/decrement.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # decrement 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 e00fbae02..c31601226 100644 --- a/styleguide/a-z-word-list-term-collections/d/default.md +++ b/styleguide/a-z-word-list-term-collections/d/default.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # default 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 8e541696a..2d4620ca2 100644 --- a/styleguide/a-z-word-list-term-collections/d/defragment.md +++ b/styleguide/a-z-word-list-term-collections/d/defragment.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # defragment 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 ec3dcb406..977f0a1dd 100644 --- a/styleguide/a-z-word-list-term-collections/d/deinstall.md +++ b/styleguide/a-z-word-list-term-collections/d/deinstall.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # deinstall 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 c89888692..e734c75bd 100644 --- a/styleguide/a-z-word-list-term-collections/d/delete.md +++ b/styleguide/a-z-word-list-term-collections/d/delete.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # delete 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 3ea70dbeb..680ca80df 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # demilitarized zone (DMZ) 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 66043aada..dee2d57c1 100644 --- a/styleguide/a-z-word-list-term-collections/d/deprecated.md +++ b/styleguide/a-z-word-list-term-collections/d/deprecated.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # deprecated 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 240ec387e..7a49bfdfc 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # depress, depressed 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 23a41ea49..7919e299d 100644 --- a/styleguide/a-z-word-list-term-collections/d/deselect.md +++ b/styleguide/a-z-word-list-term-collections/d/deselect.md @@ -1,14 +1,15 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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) 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 c01889bb1..8685bee4a 100644 --- a/styleguide/a-z-word-list-term-collections/d/desktop.md +++ b/styleguide/a-z-word-list-term-collections/d/desktop.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # desktop 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 7d2f94268..349fdb47a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # destination drive, destination file 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 539177e36..a9522c36c 100644 --- a/styleguide/a-z-word-list-term-collections/d/destination.md +++ b/styleguide/a-z-word-list-term-collections/d/destination.md @@ -1,17 +1,18 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # destination Use a more precise term, such as *website* or *folder,* to describe an end point, such as the location reached when a -customer clicks a hyperlink, the folder to which a file is copied or +customer clicks a link, the folder to which a file is copied or moved, or the document in which a linked or embedded object is stored. Use *destination* as a modifier only if necessary for clarity. 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 eb672ba6f..66cc838fe 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # device driver, driver 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 8480c8714..a18673f00 100644 --- a/styleguide/a-z-word-list-term-collections/d/device.md +++ b/styleguide/a-z-word-list-term-collections/d/device.md @@ -1,10 +1,11 @@ --- title: device - Microsoft Style Guide +description: Defines guidelines for using 'device' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # device 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 d3ba1240d..5e81095f2 100644 --- a/styleguide/a-z-word-list-term-collections/d/devops.md +++ b/styleguide/a-z-word-list-term-collections/d/devops.md @@ -1,10 +1,11 @@ --- title: DevOps - Microsoft Style Guide +description: Describes guidelines to use 'DevOps' in Microsoft documents. Carefully note spelling and capitalization. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # DevOps 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 538f3ec8f..e76bdbee3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dial-up 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 87f7fe08e..b5145915a 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,30 +1,17 @@ --- 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: 07/23/2018 +ms.date: 03/31/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dialog box, dialog, dialogue -Most of the time, avoid talking about UI elements. Talk about customer actions instead. +In general, avoid talking about UI. Instead, talk about what the customer needs to do. -When you need to refer to a dialog box, use *dialog box*—don't shorten to *dialog.* Don't use *pop-up window* or *dialogue box*. - -Don't hyphenate *dialog box* as a modifier. - -**Examples** -Word can't open this document because a dialog box is open. Close the dialog box to continue. -Select the **Paragraph** dialog box launcher, and then select **Tabs**. - -**Exception** In content for developers, it's OK to use *dialog* by itself as a modifier. For example, "This article provides information about the dialog form pattern." - -It's OK to use *dialogue* (not *dialog*) to refer to conversation or interaction between people or between a person and a computer. But use a more familiar, friendlier term such as *conversation* or *chat* if you can. - -**Examples** -It's a great way to have a conversation with the customer about what cloud technology can do for their business. -Do you want to chat with a customer service agent? +When you need to refer to a dialog box, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*. **See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) 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 815820b00..caf328a01 100644 --- a/styleguide/a-z-word-list-term-collections/d/different.md +++ b/styleguide/a-z-word-list-term-collections/d/different.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # different 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 60559f980..4ebae767e 100644 --- a/styleguide/a-z-word-list-term-collections/d/dimmed.md +++ b/styleguide/a-z-word-list-term-collections/d/dimmed.md @@ -1,17 +1,18 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dimmed 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. 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 1a6973bd0..812b1b2f2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # direction keys 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 f48b5a100..2c4388b04 100644 --- a/styleguide/a-z-word-list-term-collections/d/directory.md +++ b/styleguide/a-z-word-list-term-collections/d/directory.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # directory 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 daf23fb8f..6358a3e31 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,26 +1,29 @@ --- -title: disable, disabled - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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) +[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) + + 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 000000000..7e4913d93 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/d/disabled-(person).md @@ -0,0 +1,17 @@ +--- +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.service: microsoft-writing-style-guide +--- + +# 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 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) 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 96b43fa61..58523e65d 100644 --- a/styleguide/a-z-word-list-term-collections/d/disc.md +++ b/styleguide/a-z-word-list-term-collections/d/disc.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # disc 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 4f185d7c8..b90bcfc19 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # disjoint selection 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 2db686158..0cc19a641 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,12 +1,13 @@ --- -title: disk resource - Microsoft Style Guide +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.prod: non-product-specific +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. 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 4e1f78f79..aee4b5966 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,14 +1,21 @@ --- title: disk space - Microsoft Style Guide +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: 01/19/2018 +ms.date: 10/16/2024 ms.topic: article -ms.prod: non-product-specific +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. -**See also** [storage, storage device](~/a-z-word-list-term-collections/s/storage-storage-device.md) +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 space](~/a-z-word-list-term-collections/s/storage-storage-device.md) 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 58fd40c83..fd643ba2f 100644 --- a/styleguide/a-z-word-list-term-collections/d/disk.md +++ b/styleguide/a-z-word-list-term-collections/d/disk.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # disk 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 e50ae0ae6..f75ab08f4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # display adapter, display driver 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 317eb1cbe..4131b7404 100644 --- a/styleguide/a-z-word-list-term-collections/d/display.md +++ b/styleguide/a-z-word-list-term-collections/d/display.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # display 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 67bb477e1..f84086b98 100644 --- a/styleguide/a-z-word-list-term-collections/d/dns.md +++ b/styleguide/a-z-word-list-term-collections/d/dns.md @@ -1,10 +1,11 @@ --- title: DNS - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # DNS 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 57e2b3044..c95a6c21e 100644 --- a/styleguide/a-z-word-list-term-collections/d/document.md +++ b/styleguide/a-z-word-list-term-collections/d/document.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # document 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 30d7b20b9..6a59c796f 100644 --- a/styleguide/a-z-word-list-term-collections/d/domain.md +++ b/styleguide/a-z-word-list-term-collections/d/domain.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # domain 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 01b2eca49..7eb28bc64 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dot-com 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 8c6209d41..458794238 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dotted rectangle 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 16c875ee9..3ec8c43cf 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # double buffering 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 dddcd70fc..03210577e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # double-click, double-clicking 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 0d3481a9e..06e642721 100644 --- a/styleguide/a-z-word-list-term-collections/d/downgrade.md +++ b/styleguide/a-z-word-list-term-collections/d/downgrade.md @@ -1,10 +1,11 @@ --- title: downgrade - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # downgrade 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 ad505f107..276eda1e3 100644 --- a/styleguide/a-z-word-list-term-collections/d/download.md +++ b/styleguide/a-z-word-list-term-collections/d/download.md @@ -1,19 +1,18 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # download 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. 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 080acf28f..4cf10abc0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # drag, drag and drop 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 06b050703..251328ccc 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 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 e6edab089..ce41f62c1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # drive name 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 2d51727dd..e337d61a0 100644 --- a/styleguide/a-z-word-list-term-collections/d/drive.md +++ b/styleguide/a-z-word-list-term-collections/d/drive.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # drive diff --git a/styleguide/a-z-word-list-term-collections/d/drop-down.md b/styleguide/a-z-word-list-term-collections/d/drop-down.md deleted file mode 100644 index 8efcda0f4..000000000 --- a/styleguide/a-z-word-list-term-collections/d/drop-down.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: drop-down - Microsoft Style Guide -author: pallep -ms.author: pallep -ms.date: 05/17/2018 -ms.topic: article -ms.prod: non-product-specific ---- - -# drop-down - -It's OK to use *drop-down* as an adjective in content for developers if you need to describe the type of UI item or how it works. - -**Examples** -a drop-down menu -a drop-down combo box -a drop-down list box - -For other audiences, use *box* if you must name the UI element. - -Don't use *drop down* as a noun or verb. - -**See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) diff --git a/styleguide/a-z-word-list-term-collections/d/dropdown.md b/styleguide/a-z-word-list-term-collections/d/dropdown.md new file mode 100644 index 000000000..2dda4c77a --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/d/dropdown.md @@ -0,0 +1,21 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# dropdown + +Most of the time, avoid talking about UI elements. Instead, describe what the customer needs to do. +If you must refer to a *dropdown* menu or list, it’s OK to use *dropdown* as an adjective. Avoid using *dropdown* as a noun. (Like as a UI label: *Dropdowns*.) + +**Examples** +Pick from the options in the dropdown list. + +Use the dropdown menu to find the category you want. + +**See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md), [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md) 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 ea41f633a..5866a45ce 100644 --- a/styleguide/a-z-word-list-term-collections/d/dvd.md +++ b/styleguide/a-z-word-list-term-collections/d/dvd.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # DVD 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 edf36e05a..c4ed268cd 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dynamic-link library (DLL) 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 51f2d2203..6891e00c3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # dynamic service capacity 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 bd37edee6..756db9287 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-book 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 5d586a8b9..546c8f72d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-commerce 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 28cec5bd5..742fd5998 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-discovery 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 0b610f3e3..bad0861fe 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-form, form 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 eb415face..b741d7a85 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-learning 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 09a393fba..e8b74ac7d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-sports 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 07f829f23..d008a0c07 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,17 +1,18 @@ --- 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.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e-words 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. 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 ddc6a3093..9653097e9 100644 --- a/styleguide/a-z-word-list-term-collections/e/earlier.md +++ b/styleguide/a-z-word-list-term-collections/e/earlier.md @@ -1,15 +1,16 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # earlier -If possible, use a hyperlink to help users find information elsewhere in the content. If you can't use a hyperlink, use *earlier, preceding,* or *previous* instead of *above* to mean earlier in a piece of content. +If possible, use a hyperlink to help users find information elsewhere in the content. If you can't use a link, use *earlier, preceding,* or *previous* instead of *above* to mean earlier in a piece of content. Use *or earlier* or *previous* instead of *or lower* to refer to all versions of a product that precede a particular release if 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 29848357a..0e2babc08 100644 --- a/styleguide/a-z-word-list-term-collections/e/edutainment.md +++ b/styleguide/a-z-word-list-term-collections/e/edutainment.md @@ -1,10 +1,11 @@ --- title: edutainment - Microsoft Style Guide +description: Describes guidelines to use 'edutainment' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # edutainment 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 8d66a86e5..31850a70c 100644 --- a/styleguide/a-z-word-list-term-collections/e/eg.md +++ b/styleguide/a-z-word-list-term-collections/e/eg.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # e.g. 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 6b362408b..3bce0cfc9 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,12 +1,13 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # either/or -Don't use. Use a complete phrase, such as *either close the document or exit the program*. +Don't use. Use a complete phrase, such as *either close the document or close the program*. 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 b08327604..cd417b41c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # elastic service capacity diff --git a/styleguide/a-z-word-list-term-collections/e/ellipsis-button.md b/styleguide/a-z-word-list-term-collections/e/ellipsis-button.md index d02de8523..ed219b845 100644 --- a/styleguide/a-z-word-list-term-collections/e/ellipsis-button.md +++ b/styleguide/a-z-word-list-term-collections/e/ellipsis-button.md @@ -1,22 +1,19 @@ --- title: ellipsis button - Microsoft Style Guide +description: Describes how to refer to the ellipsis button within content and provides a graphic and description of the ellipsis button. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ellipsis button -The -name of the ellipsis button varies, based on the result of using it. +The name of the ellipsis button varies, based on the result of using it. -![](media/ellipsis-button/447573893.PNG) +![Screenshot of the square blue ellipsis icon.](media/ellipsis-button/447573893.PNG) -On -the first mention, provide a graphic of the button or include (…) after -the button name. On subsequent mentions, use the graphic rather than -the words. +On the first mention, provide a graphic of the button or include (…) after the button name. On subsequent mentions, use the graphic rather than the words. Don't capitalize *ellipsis* when used as a button name. 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 6de7a5337..23b116413 100644 --- a/styleguide/a-z-word-list-term-collections/e/email.md +++ b/styleguide/a-z-word-list-term-collections/e/email.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # email 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 ba7885f20..28251a9c7 100644 --- a/styleguide/a-z-word-list-term-collections/e/embed.md +++ b/styleguide/a-z-word-list-term-collections/e/embed.md @@ -1,10 +1,11 @@ --- title: embed - Microsoft Style Guide +description: Describes guidelines to use 'embed' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # embed 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 dc6c7adf8..1399f6a0d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # emoticons, emoji 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 17237e0fa..d47835318 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,23 +1,24 @@ --- 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 +ms.date: 11/15/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # enable, enables -Don't use *enables* (or *allows* or *lets*) to -refer to things that Microsoft or Microsoft apps make possible for -the customer. Rewrite to focus on what's important from the customer's -point of view. For example, instead of *Microsoft Edge enables you to write, draw, and take notes on webpages,* say *Write, draw, and take notes on webpages with Microsoft Edge.* +Avoid using in most cases. -Don't use to describe making commands or features available. Use *make available, turn on,* or something similar, or rewrite the sentence. +Don’t use *enables* (or *allows* or *lets*) to refer to things that Microsoft or Microsoft apps make possible for the customer. Rewrite to focus on what’s important or possible from the customer’s point of view. For example, say, "Write, draw, and take notes on webpages with Microsoft Edge," and not "Microsoft Edge enables you to write, draw, and take notes on webpages." -In content for a technical audience, it's OK to describe a feature or command as *enabled*. +Don’t use *enable* to describe making a feature, setting, or command available. Replace with specific, plain language phrases such as *turn on*, *allow*, *add*, or rewrite the sentence. -It's OK to use *enable the customer to* when you need to refer to the customer in the third person. -**Example** -Include this control to enable the customer to .... +In product UI, use *On/Off* (not *Enable/Disable*) as labels for a switch that controls the availability of a feature or a capability in the product. Or use more specific pairs of words such as *show/hide*, *add/remove*, or *allow/block*.  + +**See also** +[disable, disables (functionality)](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disable-disabled) + +[turn on, turn off](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/t/turn-on-turn-off) 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 47e2df999..dc4b4e30d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # End-User License Agreement (EULA) 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 265415feb..434e4ebe5 100644 --- a/styleguide/a-z-word-list-term-collections/e/end.md +++ b/styleguide/a-z-word-list-term-collections/e/end.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # end 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 bf9251acb..175b994cf 100644 --- a/styleguide/a-z-word-list-term-collections/e/endline.md +++ b/styleguide/a-z-word-list-term-collections/e/endline.md @@ -1,10 +1,11 @@ --- title: endline - Microsoft Style Guide +description: Describes guidelines to use 'endline' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # endline 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 2180ca223..9a4f73b46 100644 --- a/styleguide/a-z-word-list-term-collections/e/endpoint.md +++ b/styleguide/a-z-word-list-term-collections/e/endpoint.md @@ -1,10 +1,11 @@ --- title: endpoint - Microsoft Style Guide +description: Describes guidelines to use 'endpoint' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # endpoint 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 fc7465a36..19a7abfc9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ensure, insure, assure 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 0df9ac35a..72becedbb 100644 --- a/styleguide/a-z-word-list-term-collections/e/enter.md +++ b/styleguide/a-z-word-list-term-collections/e/enter.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # enter 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 fb8b5d9d0..892420d9d 100644 --- a/styleguide/a-z-word-list-term-collections/e/enterprise.md +++ b/styleguide/a-z-word-list-term-collections/e/enterprise.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # enterprise 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 952a4500a..96fc6d6f5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # entry field 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 a9d86aca4..a121a4380 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,12 +1,13 @@ --- 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/19/2018 +ms.date: 01/15/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # environment variable -Use instead of *environment setting* or *environment string*. +An *environment variable* contains configuration information that can be referenced by anything in the environment. 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 3a799d563..c39cf6034 100644 --- a/styleguide/a-z-word-list-term-collections/e/erase.md +++ b/styleguide/a-z-word-list-term-collections/e/erase.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # erase 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 5146f588d..9e055d9ed 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # et al. 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 c456fecb7..962bbc256 100644 --- a/styleguide/a-z-word-list-term-collections/e/etc.md +++ b/styleguide/a-z-word-list-term-collections/e/etc.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # etc. 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 2cfe5a2db..56da4396a 100644 --- a/styleguide/a-z-word-list-term-collections/e/euro.md +++ b/styleguide/a-z-word-list-term-collections/e/euro.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # euro 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 9fef105fa..61537360c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # executable, .exe 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 63893770d..7196af75a 100644 --- a/styleguide/a-z-word-list-term-collections/e/execute.md +++ b/styleguide/a-z-word-list-term-collections/e/execute.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # execute 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 e06dd7b5f..188afac47 100644 --- a/styleguide/a-z-word-list-term-collections/e/exit.md +++ b/styleguide/a-z-word-list-term-collections/e/exit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # exit 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 4f7ef39f4..8e3bbdaf3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # expand, collapse 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 a5c5539ad..b28b597be 100644 --- a/styleguide/a-z-word-list-term-collections/e/expose.md +++ b/styleguide/a-z-word-list-term-collections/e/expose.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # expose 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 ea7bea7ca..5b5d30c8a 100644 --- a/styleguide/a-z-word-list-term-collections/e/extend.md +++ b/styleguide/a-z-word-list-term-collections/e/extend.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # extend 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 be1beb720..4a4e14a94 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # extension, file name extension 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 fa39441fc..459d469bf 100644 --- a/styleguide/a-z-word-list-term-collections/f/FALSE.md +++ b/styleguide/a-z-word-list-term-collections/f/FALSE.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # FALSE 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 92385d42d..014ef8d99 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fail over, fail back, failover, failback 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 6f9931785..8ff302cfc 100644 --- a/styleguide/a-z-word-list-term-collections/f/fail.md +++ b/styleguide/a-z-word-list-term-collections/f/fail.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fail 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 ad5f9ffa9..648f25625 100644 --- a/styleguide/a-z-word-list-term-collections/f/family.md +++ b/styleguide/a-z-word-list-term-collections/f/family.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # family 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 e9acd8d24..ac3b17d19 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Far East 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 073c85b5c..14933c66e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # far-left, far-right 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 eda14df9b..48b88cf0a 100644 --- a/styleguide/a-z-word-list-term-collections/f/favorite.md +++ b/styleguide/a-z-word-list-term-collections/f/favorite.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # favorite 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 6f48c4f2b..56b311fd2 100644 --- a/styleguide/a-z-word-list-term-collections/f/fax.md +++ b/styleguide/a-z-word-list-term-collections/f/fax.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fax 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 05994f639..1696c4970 100644 --- a/styleguide/a-z-word-list-term-collections/f/field.md +++ b/styleguide/a-z-word-list-term-collections/f/field.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # field 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 d30e9b40a..fbe4cb4bf 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # file attributes 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 09324bac5..4d04bc019 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # File Explorer 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 6a7beb4f4..bd4286ee8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # file name extension, extension 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 1d3017b7b..428a93105 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # file name 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 0db3f4241..f893cfddd 100644 --- a/styleguide/a-z-word-list-term-collections/f/file.md +++ b/styleguide/a-z-word-list-term-collections/f/file.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # file 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 c42e9a4a6..6b97f7e63 100644 --- a/styleguide/a-z-word-list-term-collections/f/finalize.md +++ b/styleguide/a-z-word-list-term-collections/f/finalize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # finalize 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 ef91fcb2b..11bb506dc 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # find and replace 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 671cf8d6b..013371822 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 1dd574f97..05118db8f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fitness band 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 1b52a6e8b..b58f2b825 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fixed disk 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 ea643f411..b3ce0d1de 100644 --- a/styleguide/a-z-word-list-term-collections/f/flick.md +++ b/styleguide/a-z-word-list-term-collections/f/flick.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # flick 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 b08ec1743..293703f08 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # flush, flush to 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 f48bcf5c3..f5fd9ca0f 100644 --- a/styleguide/a-z-word-list-term-collections/f/flyout.md +++ b/styleguide/a-z-word-list-term-collections/f/flyout.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # flyout 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 c2e926704..ebc079c26 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # folder, folder icon 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 fc86524aa..6851a3d37 100644 --- a/styleguide/a-z-word-list-term-collections/f/following.md +++ b/styleguide/a-z-word-list-term-collections/f/following.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # following 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 e748c7534..765f44077 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # font, font style 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 c8295f106..60b4918b3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # foo, foobar, fubar 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 a448c40f2..16471bf63 100644 --- a/styleguide/a-z-word-list-term-collections/f/footer.md +++ b/styleguide/a-z-word-list-term-collections/f/footer.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # footer 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 32f556e76..2c516b46c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # foreground program 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 96129d2ec..90a72a08c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # format, formatted, formatting 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 738363bd7..bf7c25040 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # fourth-generation language 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 8d1799459..07a0a113c 100644 --- a/styleguide/a-z-word-list-term-collections/f/frameset.md +++ b/styleguide/a-z-word-list-term-collections/f/frameset.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # frameset 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 5a8f4321c..53fbca2c9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # freeze, frozen 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 bc40c318d..cef4e1ca5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # friendly name 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 aab1cc97c..cb882739f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # from vs. on 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 06906b119..5d8bf3c4a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # front end, front-end 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 c5816fe30..c2c1796d2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # full screen, full-screen 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 5a5dad61c..52c36ffbc 100644 --- a/styleguide/a-z-word-list-term-collections/f/function.md +++ b/styleguide/a-z-word-list-term-collections/f/function.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # function 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 445b45736..0a377979f 100644 --- a/styleguide/a-z-word-list-term-collections/g/gallery.md +++ b/styleguide/a-z-word-list-term-collections/g/gallery.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gallery 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 0fef0111e..a0d042419 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # game pad 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 f79fb9197..c117c254d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # garbage collection, garbage collector 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 f7e39a512..561a410b0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # General Data Protection Regulation (GDPR) 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 e1bc23f97..82316972b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # general protection fault, GP fault 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 83b3735ae..9127b0d81 100644 --- a/styleguide/a-z-word-list-term-collections/g/gigabit.md +++ b/styleguide/a-z-word-list-term-collections/g/gigabit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gigabit, Gbit 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 faa4f27c0..6bfc3bbc5 100644 --- a/styleguide/a-z-word-list-term-collections/g/gigabyte.md +++ b/styleguide/a-z-word-list-term-collections/g/gigabyte.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gigabyte, GB, G, G byte, Gbyte 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 26fa7f187..53c36f80d 100644 --- a/styleguide/a-z-word-list-term-collections/g/gigahertz.md +++ b/styleguide/a-z-word-list-term-collections/g/gigahertz.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gigahertz, GHz 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 d524bb94d..ffc04f0b3 100644 --- a/styleguide/a-z-word-list-term-collections/g/given.md +++ b/styleguide/a-z-word-list-term-collections/g/given.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # given 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 0b482aaad..ae92bdffc 100644 --- a/styleguide/a-z-word-list-term-collections/g/global.md +++ b/styleguide/a-z-word-list-term-collections/g/global.md @@ -1,13 +1,15 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # global +It's OK to use *global* to mean *worldwide*. In content for a technical audience, use *global* to refer to: @@ -15,15 +17,9 @@ In content for a technical audience, use *global* to refer to: - A variable whose value can be accessed and modified by any statement in a program. This is called a *global variable.* - Similar elements that pertain to an entire program. -Don't use *global* -in content for a general audience, especially in describing the process -of replacing one text string with another throughout a document. -Instead, describe the action or use *all instances* or *all occurrences.* - -It's OK to use *global* to mean *worldwide*. +Don't use *global* to describe the process of finding and replacing. Instead, describe the action or use *all instances* or *all occurrences.* **Examples** -A cascading style sheet establishes global design formats. Use the **Find** and **Replace** commands to find all occurrences of specific text and replace it with different text. The manufacturer is using Office 365 to expand its global supply chain. 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 0b1b6f970..719a8a0a3 100644 --- a/styleguide/a-z-word-list-term-collections/g/glyph.md +++ b/styleguide/a-z-word-list-term-collections/g/glyph.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # glyph 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 232a8eb5e..22d613787 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # go to 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 52281158a..366593ef7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # graphic, graphics, graphical 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 4b89a499b..e749be545 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # graphics adapter 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 574be8521..56b563f8c 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,17 +1,18 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gray, grayed out 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. 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 797370a06..d87c8cba5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # greater, better 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 e5f3194c3..940b9eb86 100644 --- a/styleguide/a-z-word-list-term-collections/g/greylist.md +++ b/styleguide/a-z-word-list-term-collections/g/greylist.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # greylist 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 fe3a13fb6..5962cc4b9 100644 --- a/styleguide/a-z-word-list-term-collections/g/gridline.md +++ b/styleguide/a-z-word-list-term-collections/g/gridline.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # gridline 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 f0fcc95ee..5cbc9a48d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # group box 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 3904ee844..9fc4ca726 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # group, newsgroup 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 0256c306f..fd66bf25a 100644 --- a/styleguide/a-z-word-list-term-collections/g/grow.md +++ b/styleguide/a-z-word-list-term-collections/g/grow.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # grow 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 4038a0810..bb6891e3b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hack, hacker 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 25f4a3918..bcc41f663 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # half inch 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 548fabd41..fe114b14b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # handheld, handheld device 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 15eb467e3..4b3caef91 100644 --- a/styleguide/a-z-word-list-term-collections/h/handle.md +++ b/styleguide/a-z-word-list-term-collections/h/handle.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # handle 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 268842551..60311cd28 100644 --- a/styleguide/a-z-word-list-term-collections/h/handshake.md +++ b/styleguide/a-z-word-list-term-collections/h/handshake.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # handshake 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 69a499190..f9632e76c 100644 --- a/styleguide/a-z-word-list-term-collections/h/hang.md +++ b/styleguide/a-z-word-list-term-collections/h/hang.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hang 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 e7a1c12fa..aecf9a413 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hard-code, hard-coded, hard-coding 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 eab3e172a..07342df84 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hard copy 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 079ef240b..353fac509 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hard drive 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 2a4c8549c..10d34127d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hard-of-hearing 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 fbad3c6c5..9a2909cf5 100644 --- a/styleguide/a-z-word-list-term-collections/h/hardwired.md +++ b/styleguide/a-z-word-list-term-collections/h/hardwired.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hardwired 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 1c24691e6..f84923e4d 100644 --- a/styleguide/a-z-word-list-term-collections/h/hdmi.md +++ b/styleguide/a-z-word-list-term-collections/h/hdmi.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # HDMI (High-Definition Multimedia Interface) 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 32da0ef15..8dda790be 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # he/she 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 e130c5e95..91ca330c6 100644 --- a/styleguide/a-z-word-list-term-collections/h/header.md +++ b/styleguide/a-z-word-list-term-collections/h/header.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # header 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 88c128d36..6406df081 100644 --- a/styleguide/a-z-word-list-term-collections/h/heading.md +++ b/styleguide/a-z-word-list-term-collections/h/heading.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # heading 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 db2d115b9..184465748 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hearing-impaired 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 a905a984d..26ae40882 100644 --- a/styleguide/a-z-word-list-term-collections/h/help.md +++ b/styleguide/a-z-word-list-term-collections/h/help.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Help 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 9d8400dcc..3993f8b9c 100644 --- a/styleguide/a-z-word-list-term-collections/h/hexadecimal.md +++ b/styleguide/a-z-word-list-term-collections/h/hexadecimal.md @@ -1,10 +1,11 @@ --- 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 +ms.date: 06/14/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hexadecimal @@ -12,6 +13,8 @@ ms.prod: non-product-specific Don't abbreviate as *hex*. Use *h* or *0x* when abbreviating a number. Don't insert a space between the number and *h,* and use all uppercase for alphabetical characters displayed in hexadecimal numbers. **Examples** -Interrupt 21h -addresses greater than OxFFFE +Interrupt 21h + +addresses greater than 0xFFFE + For the hexadecimal color value, enter **#FF0000**. 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 a0c68b8cd..e8a54ccae 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hierarchical menu 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 12986debe..631404e89 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # high-level-language compiler 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 7ba9c50f0..4ca267ea7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # high-quality 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 14a4f4b2f..5edb197e9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # high-resolution 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 6f9872171..12c09cdc3 100644 --- a/styleguide/a-z-word-list-term-collections/h/higher.md +++ b/styleguide/a-z-word-list-term-collections/h/higher.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # higher 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 d211c8696..5cf570f1d 100644 --- a/styleguide/a-z-word-list-term-collections/h/hint.md +++ b/styleguide/a-z-word-list-term-collections/h/hint.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hint 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 ee8383988..6d23840d4 100644 --- a/styleguide/a-z-word-list-term-collections/h/hit.md +++ b/styleguide/a-z-word-list-term-collections/h/hit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hit 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 66623dcae..f0971ed5e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # home directory 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 2a353caf4..44eff3606 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # home, home page 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 9f0b76bf7..d6c340912 100644 --- a/styleguide/a-z-word-list-term-collections/h/honeypot.md +++ b/styleguide/a-z-word-list-term-collections/h/honeypot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # honeypot 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 5bec3298e..9c20c6f21 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # host name 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 23921e8a0..2bc28a780 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,10 +1,11 @@ --- title: hosted service - Microsoft Style Guide +description: Describes how to use the term "hosted service" in Microsoft content. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hosted service 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 08367ec71..914a6af3c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hosting provider 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 10d95be87..2da4eafe7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hot key 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 96923b453..dea6b316c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hot link @@ -13,6 +14,6 @@ Don't use to describe a connection that enables information in related databases or files to be updated when information in another database or file is changed. -Don't use to refer to a hyperlink. +Don't use to refer to a link. **See also** [hyperlink](~/a-z-word-list-term-collections/h/hyperlink.md) 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 be97b0c77..ca68db43a 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,15 +1,16 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hot spot, hotspot -Don't use to refer to a hyperlink. +Don't use to refer to a link. In content for a technical audience, use two words to refer to the 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 253319c16..744c553b3 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 42a6359ef..c5b8f0fff 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # how to, how-to 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 55382f777..5f225c5fc 100644 --- a/styleguide/a-z-word-list-term-collections/h/html.md +++ b/styleguide/a-z-word-list-term-collections/h/html.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # HTML 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 fd535ca5b..85386f995 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # HTTP, HTTPS 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 0d29ec670..78e74afe8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hybrid cloud 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 204cc17e9..bea0a7dad 100644 --- a/styleguide/a-z-word-list-term-collections/h/hyperlink.md +++ b/styleguide/a-z-word-list-term-collections/h/hyperlink.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # hyperlink 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 1bd77c65f..3c72cd4ee 100644 --- a/styleguide/a-z-word-list-term-collections/i/icon.md +++ b/styleguide/a-z-word-list-term-collections/i/icon.md @@ -1,10 +1,11 @@ --- title: icon - Microsoft Style Guide +description: Describes how to refer to graphic representations within content and provides examples of referring to icons in content. author: pallep ms.author: pallep -ms.date: 07/31/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # icon @@ -17,9 +18,9 @@ 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*.<br /><br />**Example**<br />Select **Xbox** ![](media/icon/1465752354.png). +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*.<br /><br />**Example**<br />Select **Xbox** ![Screenshot of a black X box logo, a circle divided into four sections by an X.](media/icon/1465752354.png). 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**<br />Most apps have their own settings. Look for this icon ![](media/icon/10090115.PNG) in the app. +**Example**<br />Most apps have their own settings. Look for this icon ![Screenshot of a gray gear icon as it appears in applications as a settings icon.](media/icon/10090115.PNG) in the app. 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 3f11566cb..dbc04afb3 100644 --- a/styleguide/a-z-word-list-term-collections/i/iconize.md +++ b/styleguide/a-z-word-list-term-collections/i/iconize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # iconize 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 7e60cc807..d0e55c5a6 100644 --- a/styleguide/a-z-word-list-term-collections/i/ie.md +++ b/styleguide/a-z-word-list-term-collections/i/ie.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # i.e. 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 35646b33a..b29ab3840 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # if vs. whether vs. when 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 a59be847f..221b805f8 100644 --- a/styleguide/a-z-word-list-term-collections/i/illegal.md +++ b/styleguide/a-z-word-list-term-collections/i/illegal.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # illegal 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 9467f7122..30ca9019b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # image map 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 2f83a165c..abfdba5e6 100644 --- a/styleguide/a-z-word-list-term-collections/i/imbed.md +++ b/styleguide/a-z-word-list-term-collections/i/imbed.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # imbed 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 574fe9c07..a78b48369 100644 --- a/styleguide/a-z-word-list-term-collections/i/impact.md +++ b/styleguide/a-z-word-list-term-collections/i/impact.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # impact 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 10cf12433..de7451074 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # inactive, inactive state 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 534785a9c..7eff0dcb5 100644 --- a/styleguide/a-z-word-list-term-collections/i/inbound.md +++ b/styleguide/a-z-word-list-term-collections/i/inbound.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # inbound 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 24693ef6e..a6d8cf5da 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # incoming, outgoing 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 1122b4391..5e82c2448 100644 --- a/styleguide/a-z-word-list-term-collections/i/increment.md +++ b/styleguide/a-z-word-list-term-collections/i/increment.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # increment 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 04a271ebc..8666bdc32 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # indent, outdent 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 858f99a5d..5221afab9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # index, indexes, indices 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 afc71c2c1..fdebadf4c 100644 --- a/styleguide/a-z-word-list-term-collections/i/info.md +++ b/styleguide/a-z-word-list-term-collections/i/info.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # info 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 8069a61e2..fbb65297f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # infrastructure as a service (IaaS) 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 23ce6029a..d40546138 100644 --- a/styleguide/a-z-word-list-term-collections/i/initialize.md +++ b/styleguide/a-z-word-list-term-collections/i/initialize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # initialize 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 1dc22814c..20c72da5b 100644 --- a/styleguide/a-z-word-list-term-collections/i/initiate.md +++ b/styleguide/a-z-word-list-term-collections/i/initiate.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # initiate 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 d72df9049..2350407a6 100644 --- a/styleguide/a-z-word-list-term-collections/i/inline.md +++ b/styleguide/a-z-word-list-term-collections/i/inline.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # inline 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 4e93f4bc3..ebc5c0c45 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # input/output, I/O, input/output control 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 ae218aa2e..9bf249290 100644 --- a/styleguide/a-z-word-list-term-collections/i/input.md +++ b/styleguide/a-z-word-list-term-collections/i/input.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # input 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 683a6e9d0..e817f7d98 100644 --- a/styleguide/a-z-word-list-term-collections/i/insecure.md +++ b/styleguide/a-z-word-list-term-collections/i/insecure.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # insecure 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 afbf8881e..b3539239a 100644 --- a/styleguide/a-z-word-list-term-collections/i/inside.md +++ b/styleguide/a-z-word-list-term-collections/i/inside.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # inside 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 c292e625b..53c45f598 100644 --- a/styleguide/a-z-word-list-term-collections/i/install.md +++ b/styleguide/a-z-word-list-term-collections/i/install.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # install 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 0b54b5f23..4e00d51ab 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # instant message, IM 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 24fb371ad..af29ee2bc 100644 --- a/styleguide/a-z-word-list-term-collections/i/instantiate.md +++ b/styleguide/a-z-word-list-term-collections/i/instantiate.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # instantiate 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 33014fbb4..45c4e7a46 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # insure, assure, ensure 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 806b29e5f..020459e75 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # intelligence, intelligent technology 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 e983c67a0..5ae43f0ca 100644 --- a/styleguide/a-z-word-list-term-collections/i/interface.md +++ b/styleguide/a-z-word-list-term-collections/i/interface.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # interface 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 c3d69062d..7ce6c079d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Internet Connection Sharing 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 ccbde2d52..86128f823 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Internet Explorer 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 88d60625e..4be9a79b3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # internet, intranet, extranet 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 e7310efeb..ff078619c 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 c8c9d078a..2213afb93 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # internet service provider (ISP) 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 5d39a82e1..4aa2d8a9c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # invalid, not valid 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 000000000..d414cd4ca --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/i/invite.md @@ -0,0 +1,19 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# 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. 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 21875248a..acf6b1692 100644 --- a/styleguide/a-z-word-list-term-collections/i/invoke.md +++ b/styleguide/a-z-word-list-term-collections/i/invoke.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # invoke 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 96581948d..bafb25ca0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # IP address 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 299ef97e8..74f785e50 100644 --- a/styleguide/a-z-word-list-term-collections/i/issue.md +++ b/styleguide/a-z-word-list-term-collections/i/issue.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # issue 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 69e9d42c6..d85f7394b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # IT pro, IT professional 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 6b3a8921c..f353f7dd3 100644 --- a/styleguide/a-z-word-list-term-collections/i/italic.md +++ b/styleguide/a-z-word-list-term-collections/i/italic.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # italic 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 9b701ab53..8d9287db3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # its vs. it's 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 f54bec665..5cd377d49 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Java, JScript, JavaScript 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 092bdc79d..55bdcf3f8 100644 --- a/styleguide/a-z-word-list-term-collections/j/join.md +++ b/styleguide/a-z-word-list-term-collections/j/join.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # join 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 ee193380f..975787093 100644 --- a/styleguide/a-z-word-list-term-collections/j/joystick.md +++ b/styleguide/a-z-word-list-term-collections/j/joystick.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # joystick 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 58a153ae5..b90b80732 100644 --- a/styleguide/a-z-word-list-term-collections/j/jump.md +++ b/styleguide/a-z-word-list-term-collections/j/jump.md @@ -1,14 +1,15 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # jump -Don't use as a noun to refer to cross-references to other pages or to hyperlinks. +Don't use as a noun to refer to cross-references to other pages or to links. Don't use as a verb to refer to going from one link to another. Use *go to* instead. 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 6e3aba4f5..a92f06e36 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # justify, justified 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 52016fc82..93e0c5f8a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Kerberos protocol 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 89d951f8d..f5f93c77a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # key combination 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 new file mode 100644 index 000000000..29aada981 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/k/key-performance-indicator-(KPI).md @@ -0,0 +1,19 @@ +--- +title: key performance indicator (KPI) - Microsoft Style Guide +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# 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)](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)) 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 000000000..3f02cd79d --- /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)](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)) 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 11cef5866..4039f56c5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # key sequence 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 ee382ca52..aa117c667 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # keyboard shortcut 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 6adafd51b..11ff002b6 100644 --- a/styleguide/a-z-word-list-term-collections/k/keypad.md +++ b/styleguide/a-z-word-list-term-collections/k/keypad.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # keypad 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 4036eea62..13503d8bf 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # keypress, keystroke 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 c1414bf7a..85aa6791d 100644 --- a/styleguide/a-z-word-list-term-collections/k/kilobit.md +++ b/styleguide/a-z-word-list-term-collections/k/kilobit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # kilobit, Kbit 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 2773f92f9..16d7ea3d0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # kilobits per second, Kbps 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 b2f80b2c7..2a6b19243 100644 --- a/styleguide/a-z-word-list-term-collections/k/kilobyte.md +++ b/styleguide/a-z-word-list-term-collections/k/kilobyte.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # kilobyte, KB, K, K byte, Kbyte 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 6577b0d9c..db718b5a5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # kilobytes per second, KBps 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 65fa649b9..88bec90fc 100644 --- a/styleguide/a-z-word-list-term-collections/k/kilohertz.md +++ b/styleguide/a-z-word-list-term-collections/k/kilohertz.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # kilohertz, KHz 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 69ade3912..786015e82 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # knowledge base, Knowledge Base 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 90c18c920..c8c989de9 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,10 +1,11 @@ --- title: labeled, labeling - Microsoft Style Guide +description: Guidelines for using the terms labeled and labeling in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # labeled, labeling 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 c7507cf34..4bc916709 100644 --- a/styleguide/a-z-word-list-term-collections/l/laptop.md +++ b/styleguide/a-z-word-list-term-collections/l/laptop.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # laptop 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 3d505141e..44c91f71f 100644 --- a/styleguide/a-z-word-list-term-collections/l/later.md +++ b/styleguide/a-z-word-list-term-collections/l/later.md @@ -1,21 +1,24 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # later -If possible, use a hyperlink to help readers find information elsewhere in the content. If you can't use a hyperlink, use *later* instead of *below* in cross-references such as *later in this article.* +If possible, use a link to help readers find information elsewhere in the content. If you can't use a link, use *later* instead of *below* in cross-references such as *later in this article.* -It's OK to use or later to refer to multiple versions of software. Keep in mind that the phrases and later and or later might imply that the functionality or feature discussed will be included or supported in all future releases. If you're not sure, list each applicable version instead. +It's OK to use *or later* or *and later* to refer to multiple versions of software. Keep in mind that the phrases and later and or later might imply that the functionality or feature discussed will be included or supported in all future releases. If you're not sure, list each applicable version instead. **Examples** Internet Explorer 7 or later, Firefox 3.6 or later -Windows 7, Windows 8, Windows 8.1, Windows 10, and later. -Download and install the Power BI publisher for Excel of desktop versions of Microsoft Excel 2010 with SPI and later. + +Windows 7, Windows 8, Windows 8.1, Windows 10, and later. + +Download and install the Power BI publisher for Excel to use with Microsoft Excel 2010 or later versions. **See also** [earlier](~/a-z-word-list-term-collections/e/earlier.md) 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 1944b2a66..f393dcdfd 100644 --- a/styleguide/a-z-word-list-term-collections/l/launch.md +++ b/styleguide/a-z-word-list-term-collections/l/launch.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # launch 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 6c312c406..0b02c26e9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lay out, laid out, layout 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 f709a5630..2c3731c84 100644 --- a/styleguide/a-z-word-list-term-collections/l/leading.md +++ b/styleguide/a-z-word-list-term-collections/l/leading.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # leading 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 7eb37cf55..7da938e97 100644 --- a/styleguide/a-z-word-list-term-collections/l/leave.md +++ b/styleguide/a-z-word-list-term-collections/l/leave.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # leave 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 ab70bec10..bff72c1f9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # left align, left-aligned 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 d68981481..b5561c831 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # left justify, left-justified 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 a84c945e0..2bb54dc92 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # left, leftmost, left-hand 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 df4ecb2ab..60fa6c46a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # left mouse button 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 a8cc68363..d3c118025 100644 --- a/styleguide/a-z-word-list-term-collections/l/legacy.md +++ b/styleguide/a-z-word-list-term-collections/l/legacy.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # legacy 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 c4224f43e..a7dcb8c41 100644 --- a/styleguide/a-z-word-list-term-collections/l/legal.md +++ b/styleguide/a-z-word-list-term-collections/l/legal.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # legal 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 30f34efcc..54a731817 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,10 +1,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # less vs. fewer vs. under @@ -16,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. 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 2be63bbd4..a7fa2bc2e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # let, lets 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 a129036e0..613b94d6a 100644 --- a/styleguide/a-z-word-list-term-collections/l/leverage.md +++ b/styleguide/a-z-word-list-term-collections/l/leverage.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # leverage 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 4a5fa7854..d7742f083 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # license terms 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 403c9da4a..aafdcd321 100644 --- a/styleguide/a-z-word-list-term-collections/l/like.md +++ b/styleguide/a-z-word-list-term-collections/l/like.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # \-like 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 be36ea769..c7aa753a5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # line of business, line-of-business 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 366c94a8f..2632264b6 100644 --- a/styleguide/a-z-word-list-term-collections/l/line.md +++ b/styleguide/a-z-word-list-term-collections/l/line.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # line 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 d8f146902..f08b4d233 100644 --- a/styleguide/a-z-word-list-term-collections/l/link.md +++ b/styleguide/a-z-word-list-term-collections/l/link.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # link 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 1992a32ab..4a36ea475 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # list box 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 ad4b6d0b1..0d24f4dfd 100644 --- a/styleguide/a-z-word-list-term-collections/l/load.md +++ b/styleguide/a-z-word-list-term-collections/l/load.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # load 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 536ab638b..f2f057b75 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lock up 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 112053183..9de9025be 100644 --- a/styleguide/a-z-word-list-term-collections/l/lock.md +++ b/styleguide/a-z-word-list-term-collections/l/lock.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lock 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 b05c21c37..08acf34fe 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # log on, log off 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 02552f56d..1ab3ae14a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # low-resolution 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 275b6f9cd..2ed7caa13 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lower left, lower-left, lower right, lower-right 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 77cbc2cc4..02047deac 100644 --- a/styleguide/a-z-word-list-term-collections/l/lower.md +++ b/styleguide/a-z-word-list-term-collections/l/lower.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lower 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 b944c2c11..e05173d7c 100644 --- a/styleguide/a-z-word-list-term-collections/l/lowercase.md +++ b/styleguide/a-z-word-list-term-collections/l/lowercase.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # lowercase 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 3830cd782..0a26401e2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # machine learning 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 04feaabd8..513121f5d 100644 --- a/styleguide/a-z-word-list-term-collections/m/machine.md +++ b/styleguide/a-z-word-list-term-collections/m/machine.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # machine 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 70a160a8c..8636a168f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # main document 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 49343970b..e8da61bb7 100644 --- a/styleguide/a-z-word-list-term-collections/m/makefile.md +++ b/styleguide/a-z-word-list-term-collections/m/makefile.md @@ -1,10 +1,11 @@ --- title: makefile - Microsoft Style Guide +description: Describes guidelines to use 'makefile' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # makefile 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 dfcbb8761..577846e78 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # malicious code 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 f72c2615e..04ef6ce83 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # malicious user 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 3d62c3a25..d370aac5f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # malware, malicious software 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 c96151b7f..4fccaac33 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # management information systems 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 e24ad5e9a..009f1354a 100644 --- a/styleguide/a-z-word-list-term-collections/m/manipulate.md +++ b/styleguide/a-z-word-list-term-collections/m/manipulate.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # manipulate 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 b658c74af..2284bceeb 100644 --- a/styleguide/a-z-word-list-term-collections/m/marquee.md +++ b/styleguide/a-z-word-list-term-collections/m/marquee.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # marquee diff --git a/styleguide/a-z-word-list-term-collections/m/master-slave-master-subordinate.md b/styleguide/a-z-word-list-term-collections/m/master-slave-master-subordinate.md deleted file mode 100644 index 4fac5874b..000000000 --- a/styleguide/a-z-word-list-term-collections/m/master-slave-master-subordinate.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: master/slave, master/subordinate - Microsoft Style Guide -author: pallep -ms.author: pallep -ms.date: 02/10/2018 -ms.topic: article -ms.prod: non-product-specific ---- - -# master/slave, master/subordinate - -Don't use *master/slave.* -In content for a technical audience, it's OK to substitute *subordinate* for *slave.* - -Use *master/subordinate* as an adjective. Refer to arrangements in which one device controls another as a *master/subordinate arrangement,* or refer to the controlling device as the *master server* and the controlled device as the *subordinate server.* - -When you need to clarify the concept, it's OK to reference the use of *slave* as an adjective by saying *also known as the slave server.* It's OK to use *master server* and *slave server* as synonyms in keyword lists. - -Avoid using *slave* as an adjective. Never use *slave* as a noun. - -Don't use *master/subordinate* as a synonym for *parent/child.* - -**Examples**<br />Each subordinate device has a unique 7-bit or 10-bit address. <br />The architecture uses a standard master/subordinate design to replicate data from one server to many. - -**See also** [parent/child](~/a-z-word-list-term-collections/p/parent-child.md) 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 new file mode 100644 index 000000000..9fbd7e5e6 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/m/master-slave.md @@ -0,0 +1,23 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# master/slave + +Don't use *master/slave*. Use *primary/replica* or alternatives such as *primary/secondary*, *principal/agent*, *controller/worker*, or other appropriate terms depending on the context. + +Use *primary/subordinate* as an adjective. Refer to arrangements in which one device controls another as a *primary/subordinate arrangement*, or refer to the controlling device as the *primary server* and the controlled device as the subordinate server. + +Don't use *primary/subordinate* as a synonym for *parent/child*. + +**Examples** +Each subordinate device has a unique 7-bit or 10-bit address. +The architecture uses a standard primary/subordinate design to replicate data from one server to many. + +**See also** [parent/child](~/a-z-word-list-term-collections/p/parent-child.md) 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 ab5cd37ba..362900084 100644 --- a/styleguide/a-z-word-list-term-collections/m/mathematical.md +++ b/styleguide/a-z-word-list-term-collections/m/mathematical.md @@ -1,10 +1,11 @@ --- title: mathematical - Microsoft Style Guide +description: In Microsoft documents, use 'mathematical' instead of 'mathematic'. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mathematical 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 73d80dd22..1e9bfc891 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # matrix, matrices 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 e72ef6d16..5c3daa3a0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Maximize button, maximize @@ -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 ![](media/maximize-button-maximize/302251874.png). +Select ![Screenshot of a gray square with a smaller black square within it to indicate that a screen can be maximized.](media/maximize-button-maximize/302251874.png). 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 623f2b934..6ff56e1dd 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # medium, media 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 d40777ffc..7e70e3599 100644 --- a/styleguide/a-z-word-list-term-collections/m/megabit.md +++ b/styleguide/a-z-word-list-term-collections/m/megabit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # megabit, Mb, Mbit 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 8ca5d1498..bf34b5491 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # megabits per second, Mbps 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 e260242ca..567fea62e 100644 --- a/styleguide/a-z-word-list-term-collections/m/megabyte.md +++ b/styleguide/a-z-word-list-term-collections/m/megabyte.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # megabyte, MB, meg, M, M byte, Mbyte 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 a0378cc2c..88e85e496 100644 --- a/styleguide/a-z-word-list-term-collections/m/megahertz.md +++ b/styleguide/a-z-word-list-term-collections/m/megahertz.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # megahertz, MHz 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 7e3092108..2c9a55b8d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # member function 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 55827cadd..28a448177 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # memory-resident 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 5c27a9372..cce46e850 100644 --- a/styleguide/a-z-word-list-term-collections/m/memory.md +++ b/styleguide/a-z-word-list-term-collections/m/memory.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # memory 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 096581430..849f6a22f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # menu item 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 0c6946dee..f66b834f5 100644 --- a/styleguide/a-z-word-list-term-collections/m/message.md +++ b/styleguide/a-z-word-list-term-collections/m/message.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # message 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 3a81f9e0e..2f16f4597 100644 --- a/styleguide/a-z-word-list-term-collections/m/metafile.md +++ b/styleguide/a-z-word-list-term-collections/m/metafile.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # metafile 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 8308f58d1..382638a19 100644 --- a/styleguide/a-z-word-list-term-collections/m/micro.md +++ b/styleguide/a-z-word-list-term-collections/m/micro.md @@ -1,14 +1,15 @@ --- 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.prod: non-product-specific +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). 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 b1925930a..4fe3fcb02 100644 --- a/styleguide/a-z-word-list-term-collections/m/microprocessor.md +++ b/styleguide/a-z-word-list-term-collections/m/microprocessor.md @@ -1,10 +1,11 @@ --- title: microprocessor - Microsoft Style Guide +description: Describes guidelines to use 'microprocessor' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # microprocessor 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 e1752eef6..6e9ed2229 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft account 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 0bc44d93a..e5ffdd5fa 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft AI 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 8d985012a..b03e42a50 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft Store 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 ee011db1b..3ab2163b1 100644 --- a/styleguide/a-z-word-list-term-collections/m/microsoft.md +++ b/styleguide/a-z-word-list-term-collections/m/microsoft.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft 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 69deed52e..79f8eff4a 100644 --- a/styleguide/a-z-word-list-term-collections/m/midnight.md +++ b/styleguide/a-z-word-list-term-collections/m/midnight.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # midnight 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 88dbf2466..b27a7e632 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # million, M 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 26405fad8..e1bca40ec 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Minimize button, minimize @@ -15,4 +16,4 @@ It's OK to use *minimize* as a verb. **Examples** Select the **Minimize** button. -Select ![](media/minimize-button-minimize/1223646377.png). +Select ![Screenshot of a gray square with a smaller black line in the center to indicate that a screen can be minimized.](media/minimize-button-minimize/1223646377.png). 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 b254d4525..dd0e7e0e0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # minus sign (–) 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 bddec443f..b265a911f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # MIP mapping 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 9c235f8fb..e64a302ef 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mission critical, mission-critical 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 cf776ee8d..11c4de5e9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mixed reality, mixed-reality 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 13a180881..46fc0cb35 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mobile device, mobile phone 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 2713cd080..74c2da3bd 100644 --- a/styleguide/a-z-word-list-term-collections/m/monitor.md +++ b/styleguide/a-z-word-list-term-collections/m/monitor.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # monitor 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 f87b3666b..e1b8280bb 100644 --- a/styleguide/a-z-word-list-term-collections/m/monospace.md +++ b/styleguide/a-z-word-list-term-collections/m/monospace.md @@ -1,10 +1,11 @@ --- title: monospace - Microsoft Style Guide +description: Describes guidelines to use 'monospace' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # monospace 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 9ba9f40e5..2f64ed5c3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # more than vs. over 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 7a96cee7f..db55ab35f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mouse over 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 30aeeef63..32e77beed 100644 --- a/styleguide/a-z-word-list-term-collections/m/mouse.md +++ b/styleguide/a-z-word-list-term-collections/m/mouse.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # mouse 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 248013b56..79b0cbed7 100644 --- a/styleguide/a-z-word-list-term-collections/m/movable.md +++ b/styleguide/a-z-word-list-term-collections/m/movable.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # movable 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 0a59e3fa9..448924c3f 100644 --- a/styleguide/a-z-word-list-term-collections/m/move.md +++ b/styleguide/a-z-word-list-term-collections/m/move.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # move 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 243597231..f32967a8b 100644 --- a/styleguide/a-z-word-list-term-collections/m/mpeg.md +++ b/styleguide/a-z-word-list-term-collections/m/mpeg.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # MPEG 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 981feae9d..e77e2d4fe 100644 --- a/styleguide/a-z-word-list-term-collections/m/multi.md +++ b/styleguide/a-z-word-list-term-collections/m/multi.md @@ -1,16 +1,19 @@ --- 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: 01/19/2018 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multi- -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-.* +In general, don't hyphenate words beginning with *multi-* unless it's necessary to avoid confusion or *multi-* is followed by a proper noun. -**Examples**<br />multicast <br />multichannel <br />multicolumn <br />multilevel <br />multiline <br />multilingual <br />multimedia <br />multiprocessor <br />multitasking <br />multiuser +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. -To learn more about hyphenation, see [Hyphens](~/punctuation/dashes-hyphens/hyphens.md). +**Examples**<br />multicast <br />multichannel <br />multicloud <br />multicolumn <br />multiline <br />multiprocessor + +To learn more about hyphenation, **see also** [Hyphens](~/punctuation/dashes-hyphens/hyphens.md). 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 e427822c2..39abe33f2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multifactor authentication 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 a2054ca62..1109295a7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multiple selection 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 bc07dcc26..3abc96e72 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multiplication sign (×) 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 18b4e7752..d050e37e5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multitask, multitasking 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 c4ee0272c..6cc369d46 100644 --- a/styleguide/a-z-word-list-term-collections/m/multithreaded.md +++ b/styleguide/a-z-word-list-term-collections/m/multithreaded.md @@ -1,10 +1,11 @@ --- title: multithreaded - Microsoft Style Guide +description: Describes guidelines to use 'multithreaded' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # multithreaded 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 199985f3a..9b1d12695 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft Software License Terms 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 3b37beed5..1fcb6bc4b 100644 --- a/styleguide/a-z-word-list-term-collections/n/n.md +++ b/styleguide/a-z-word-list-term-collections/n/n.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # n 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 9123868eb..e0f5f2eb1 100644 --- a/styleguide/a-z-word-list-term-collections/n/namespace.md +++ b/styleguide/a-z-word-list-term-collections/n/namespace.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # namespace 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 f902f1eb3..949609fe5 100644 --- a/styleguide/a-z-word-list-term-collections/n/nanosecond.md +++ b/styleguide/a-z-word-list-term-collections/n/nanosecond.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # nanosecond 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 4dfb4a61d..d76ed069a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # native language 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 a60a0e782..afe2bf579 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # natural user interface, NUI 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 a97d55873..c55efb195 100644 --- a/styleguide/a-z-word-list-term-collections/n/navigate.md +++ b/styleguide/a-z-word-list-term-collections/n/navigate.md @@ -1,17 +1,18 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # navigate Don't use to describe going from place to place on the internet or an intranet. Use *browse* instead. -To describe going directly to a webpage or website, whether by entering a URL or selecting a hyperlink, use *go to*. +To describe going directly to a webpage or website, whether by entering a URL or selecting a link, use *go to*. **Examples** To browse the web, select any link on your home page. 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 12ed0005b..e911d0bc7 100644 --- a/styleguide/a-z-word-list-term-collections/n/need.md +++ b/styleguide/a-z-word-list-term-collections/n/need.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # need 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 29e1b9440..627580109 100644 --- a/styleguide/a-z-word-list-term-collections/n/net.md +++ b/styleguide/a-z-word-list-term-collections/n/net.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # .NET 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 1fdb4484e..a44b02c53 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # network adapter 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 59b64da99..0cb8c131e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # network administrator 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 87b01e5ba..8f0e03520 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # network connection 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 82c68be63..4ed85577a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # network drive 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 49a28775d..903cef5fb 100644 --- a/styleguide/a-z-word-list-term-collections/n/network.md +++ b/styleguide/a-z-word-list-term-collections/n/network.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # network 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 ee5031649..c413d9f46 100644 --- a/styleguide/a-z-word-list-term-collections/n/newsreader.md +++ b/styleguide/a-z-word-list-term-collections/n/newsreader.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # newsreader 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 3ae8f38e8..572a0b653 100644 --- a/styleguide/a-z-word-list-term-collections/n/non.md +++ b/styleguide/a-z-word-list-term-collections/n/non.md @@ -1,16 +1,16 @@ --- 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.prod: non-product-specific +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** 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 75fc00dfb..875b4b0aa 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # nonadjacent selection 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 00d3acc6b..1eea7b3be 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # noncontiguous selection 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 bc0e85f5f..d7274546d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # nonprintable, nonprinting 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 66b2b58e0..38959c1a9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # normal, normally 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 51d540db5..100ff1376 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,26 +1,17 @@ --- title: notification area - Microsoft Style Guide +description: Describes guidelines to use 'notification area' in Microsoft documents and links to related term. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 12/22/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # notification area -Lowercase. +In Windows 8 and Windows 10, use to refer to the area on the taskbar where the clock and system notifications appear. -Use only to describe the area on the right side of the taskbar where the clock and system notifications appear. +In Windows 11, this UI element is referred to as the *system tray*. -Don't use the following terms as synonyms for *notification area:* - - - system tray - - systray - - status area - -Don't use the word *area* by itself to refer to the notification area. Avoid descriptions that might imply there's more than one notification area. - -**Examples** -The clock appears in the notification area, at the far right of the taskbar. -The notification area is located at the far right of the taskbar. +**See also** [system tray](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/system-tray) 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 3103d24ae..46b07f69d 100644 --- a/styleguide/a-z-word-list-term-collections/n/notification.md +++ b/styleguide/a-z-word-list-term-collections/n/notification.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # notification 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 bf44a3227..d6d8268a7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # null-terminated, null-terminating 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 491e5c770..41c2acc70 100644 --- a/styleguide/a-z-word-list-term-collections/n/null.md +++ b/styleguide/a-z-word-list-term-collections/n/null.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # null, NULL, Null 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 a1f7d34b4..d6d505d01 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # number sign (\#) 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 151c95d6d..3be993d2a 100644 --- a/styleguide/a-z-word-list-term-collections/n/numeric.md +++ b/styleguide/a-z-word-list-term-collections/n/numeric.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # numeric 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 954054e50..4d6a90b1b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 2D, two-dimensional 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 d79acf38d..7e4a1fe60 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 3D, three-dimensional 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 aa99d3ff4..1e2926ae4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 8.5" × 11" paper 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 4ce4b08cc..16af22231 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 24/7 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 44bb57938..9f2cf6bf9 100644 --- a/styleguide/a-z-word-list-term-collections/o/object.md +++ b/styleguide/a-z-word-list-term-collections/o/object.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # object 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 000000000..9650a3ec5 --- /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.service: microsoft-writing-style-guide +--- + +# 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)](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)) 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 d59dc5b4b..3cd2b4bdc 100644 --- a/styleguide/a-z-word-list-term-collections/o/obsolete.md +++ b/styleguide/a-z-word-list-term-collections/o/obsolete.md @@ -1,10 +1,11 @@ --- title: obsolete - Microsoft Style Guide +description: Describes guidelines to use 'obsolete' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # obsolete 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 d5b7a976a..a97714fcc 100644 --- a/styleguide/a-z-word-list-term-collections/o/of.md +++ b/styleguide/a-z-word-list-term-collections/o/of.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # of 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 01e9a9087..feee70c96 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # off-premises, on-premises 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 7251413e5..ef2ae30f7 100644 --- a/styleguide/a-z-word-list-term-collections/o/offline.md +++ b/styleguide/a-z-word-list-term-collections/o/offline.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # offline 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 c8a93c219..527cc986d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # OK, okay 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 d21652989..c649b66c1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # on-screen keyboard 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 0cd28505e..ff773e04a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # on-screen 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 1264d8965..6e098d298 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # on the fly 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 c52bdf45a..cca7a7eb1 100644 --- a/styleguide/a-z-word-list-term-collections/o/on.md +++ b/styleguide/a-z-word-list-term-collections/o/on.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # on 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 9fd624501..e64bc10f8 100644 --- a/styleguide/a-z-word-list-term-collections/o/onboarding.md +++ b/styleguide/a-z-word-list-term-collections/o/onboarding.md @@ -1,10 +1,11 @@ --- title: onboarding - Microsoft Style Guide +description: Describes guidelines to use 'onboarding' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # onboarding 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 793e2805b..08cbd7a08 100644 --- a/styleguide/a-z-word-list-term-collections/o/once.md +++ b/styleguide/a-z-word-list-term-collections/o/once.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # once 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 f99fbd52f..e4dd8c7e1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # online services 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 f4d2fafd3..10681febf 100644 --- a/styleguide/a-z-word-list-term-collections/o/online.md +++ b/styleguide/a-z-word-list-term-collections/o/online.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # online 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 22a43f2b4..efae91edb 100644 --- a/styleguide/a-z-word-list-term-collections/o/onto.md +++ b/styleguide/a-z-word-list-term-collections/o/onto.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # onto 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 2edb72de9..eabe7fa08 100644 --- a/styleguide/a-z-word-list-term-collections/o/opcode.md +++ b/styleguide/a-z-word-list-term-collections/o/opcode.md @@ -1,10 +1,11 @@ --- title: opcode - Microsoft Style Guide +description: Describes guidelines to use 'opcode' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # opcode 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 788f5ffb0..1032fac83 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # open source, open-source 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 5b45aad08..93a37794a 100644 --- a/styleguide/a-z-word-list-term-collections/o/open.md +++ b/styleguide/a-z-word-list-term-collections/o/open.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # open 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 1ae58ea00..74416de96 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # operating environment, operating system 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 52fd5109f..c5b4c06ad 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # opt in, opt out 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 cc5060e1f..1fce45ba9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # option, option button 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 398b40f10..3fd848e0c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # org, organization 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 1b88d13ed..eb636a42f 100644 --- a/styleguide/a-z-word-list-term-collections/o/output.md +++ b/styleguide/a-z-word-list-term-collections/o/output.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # output 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 8b033aeb1..86d818d1d 100644 --- a/styleguide/a-z-word-list-term-collections/o/outside.md +++ b/styleguide/a-z-word-list-term-collections/o/outside.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # outside 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 7a483517d..824f8b25d 100644 --- a/styleguide/a-z-word-list-term-collections/o/over.md +++ b/styleguide/a-z-word-list-term-collections/o/over.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # over 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 a4aafa443..3052ca811 100644 --- a/styleguide/a-z-word-list-term-collections/o/overwrite.md +++ b/styleguide/a-z-word-list-term-collections/o/overwrite.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # overwrite 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 fa882c435..f821cdfaa 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # p-code 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 0fcc64dc4..af3d425f8 100644 --- a/styleguide/a-z-word-list-term-collections/p/page.md +++ b/styleguide/a-z-word-list-term-collections/p/page.md @@ -1,10 +1,11 @@ --- title: page - Microsoft Style Guide +description: Describes guidelines to use 'page' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # page 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 e2a1a9278..890c5fe10 100644 --- a/styleguide/a-z-word-list-term-collections/p/palette.md +++ b/styleguide/a-z-word-list-term-collections/p/palette.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # palette 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 1a9cc2b1c..7055b7f84 100644 --- a/styleguide/a-z-word-list-term-collections/p/pan.md +++ b/styleguide/a-z-word-list-term-collections/p/pan.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pan 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 7ca50ba25..edd490c0d 100644 --- a/styleguide/a-z-word-list-term-collections/p/pane.md +++ b/styleguide/a-z-word-list-term-collections/p/pane.md @@ -1,10 +1,11 @@ --- 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: 11/01/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pane @@ -12,8 +13,10 @@ 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 on 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*. +Use the preposition *on* when referring to the contents of a pane. + **See also** [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md), [Formatting text in instructions](~/procedures-instructions/formatting-text-in-instructions.md) 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 b30568275..5d91254af 100644 --- a/styleguide/a-z-word-list-term-collections/p/parameter.md +++ b/styleguide/a-z-word-list-term-collections/p/parameter.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # parameter 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 2eb2ea22d..d66f064e8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # parent/child @@ -14,6 +15,6 @@ content for a technical audience to refer to the relationships among processes in a multitasking environment or in content about databases to describe the relationships among nodes in a tree structure. -Don't use as a synonym for a master/subordinate relationship. +Don't use as a synonym for a primary/subordinate relationship. -**See also** [master/slave, master/subordinate](~/a-z-word-list-term-collections/m/master-slave-master-subordinate.md) +**See also** [master/slave](~/a-z-word-list-term-collections/m/master-slave.md) 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 49e934ea7..136f1363a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # parenthesis, parentheses 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 b0da8f214..5adfc159c 100644 --- a/styleguide/a-z-word-list-term-collections/p/passwordless.md +++ b/styleguide/a-z-word-list-term-collections/p/passwordless.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # passwordless 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 30507963d..0e4ad7431 100644 --- a/styleguide/a-z-word-list-term-collections/p/path.md +++ b/styleguide/a-z-word-list-term-collections/p/path.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # path 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 1b995fbbb..c5f975f88 100644 --- a/styleguide/a-z-word-list-term-collections/p/pc.md +++ b/styleguide/a-z-word-list-term-collections/p/pc.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # PC 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 8cb26999c..bd1351984 100644 --- a/styleguide/a-z-word-list-term-collections/p/pen.md +++ b/styleguide/a-z-word-list-term-collections/p/pen.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pen 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 4e74b4a76..e81b197e3 100644 --- a/styleguide/a-z-word-list-term-collections/p/per.md +++ b/styleguide/a-z-word-list-term-collections/p/per.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # per 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 1d9475634..7622ec65c 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,43 +1,19 @@ --- -title: percent, percentage - Microsoft Style Guide +title: percent, percent sign (%), percentage - Microsoft Style Guide +description: Describes guidelines to use 'percent' or 'percentage' in Microsoft documents and provides exception examples. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 11/15/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # percent, percentage -One word. Spell out unless space is constrained. When spelling out *percent,* insert a space between the number and the word. +Use the percent sign (“%”) with numerals, rather than spelling out “percent.” You don’t need a space between the percent sign and the numeral. -It's OK to use the percent sign (%): +**Exceptions** + - Don't use "%" to refer to the symbol itself—refer to the “percent sign.” + - Don't use the percent sign at the beginning of a sentence. + - Don't use the percent sign to mean "percentage." - - In data-intensive content, such as tables, charts, and dashboards. - - To save space in UI (such as in controls). - - As a technical symbol. - -Always use a numeral with *percent,* no matter how small. - -**Examples** -At least 50 percent of your system resources should be available. -Only 1 percent of the test group was unable to complete the task. - -**Exception** -When you use *percent* in column headings to name the rate percent term in the percentage formula (base \* rate percent = percentage), you can use *percent* without a numeral. (See the following examples.) - -Use *percentage:* - - - When you don't specify a quantity, such as in the phrase *a large percentage of system resources.* - - When applying the percentage formula (base \* rate percent = percentage)*.* - -**Examples** - -| List price | Discount percent | Discount percentage |Sales price| -|---|---|---|---| -| $200 | 5% | $10.00 |$190.00| - -10.00 USD is the percentage discount calculated by applying a 10 percent discount to a list price of 100.00 USD. $100.00 \* 10% = $10.00. - - - 10 percent is the percent discount. - - $10.00 is the percentage discount. 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 00f6b02d3..a0d2e42c7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # perimeter network 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 3d32fd99c..6605c4751 100644 --- a/styleguide/a-z-word-list-term-collections/p/peripheral.md +++ b/styleguide/a-z-word-list-term-collections/p/peripheral.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # peripheral 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 ec6f40374..a32831a84 100644 --- a/styleguide/a-z-word-list-term-collections/p/permissions.md +++ b/styleguide/a-z-word-list-term-collections/p/permissions.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # permissions 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 5af991f4c..f1c85279f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # personal digital assistant 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 e94cf96e8..8e10ee4fb 100644 --- a/styleguide/a-z-word-list-term-collections/p/phone.md +++ b/styleguide/a-z-word-list-term-collections/p/phone.md @@ -1,12 +1,20 @@ --- -title: phone - Microsoft Style Guide +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: 01/19/2018 +ms.date: 05/13/2022 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# phone +# phone, phone number + +Don’t use *telephone number*. Use *phone number* instead. + +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](/style-guide/numbers). -**See** [Computer and device term collection](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md) 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 8a76046b4..c41115c9f 100644 --- a/styleguide/a-z-word-list-term-collections/p/photo.md +++ b/styleguide/a-z-word-list-term-collections/p/photo.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # photo 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 87a1c5aac..348a7f5d1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pin, unpin @@ -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** ![](media/pin-unpin/967781121.png) button, and then select **All apps**. +1. Select the **Start** ![Screenshot of a black Windows icon as it appears as the Start button on Windows.](media/pin-unpin/967781121.png) 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/p/pinch.md b/styleguide/a-z-word-list-term-collections/p/pinch.md index 0948a8356..837a6f2c9 100644 --- a/styleguide/a-z-word-list-term-collections/p/pinch.md +++ b/styleguide/a-z-word-list-term-collections/p/pinch.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pinch 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 280f8b26f..f9f1c1ca8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ping, PING 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 b6a9c371d..51db6afb6 100644 --- a/styleguide/a-z-word-list-term-collections/p/pipe.md +++ b/styleguide/a-z-word-list-term-collections/p/pipe.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pipe 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 2c014c765..c7478e5ca 100644 --- a/styleguide/a-z-word-list-term-collections/p/placeholder.md +++ b/styleguide/a-z-word-list-term-collections/p/placeholder.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # placeholder 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 a3db2e36d..00264cc23 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # plaintext, plain text 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 621f7f792..457d3d9c2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # platform as a service (PaaS) 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 b06f05a38..7ae2543bd 100644 --- a/styleguide/a-z-word-list-term-collections/p/platform.md +++ b/styleguide/a-z-word-list-term-collections/p/platform.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # platform 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 4a2f91df1..c00c69f55 100644 --- a/styleguide/a-z-word-list-term-collections/p/playlist.md +++ b/styleguide/a-z-word-list-term-collections/p/playlist.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # playlist 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 5ce673dbb..c85554e97 100644 --- a/styleguide/a-z-word-list-term-collections/p/please.md +++ b/styleguide/a-z-word-list-term-collections/p/please.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # please 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 52528ab2f..26aba2420 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Plug and Play, plug and play 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 c10b83801..28c67b2c4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # plug-in 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 51d23dfcc..3e0764119 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # plus sign (+) 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 a6b98df15..204293c36 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # point to 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 ae215e8c5..a3b40c4fb 100644 --- a/styleguide/a-z-word-list-term-collections/p/pointer.md +++ b/styleguide/a-z-word-list-term-collections/p/pointer.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pointer 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 0657c351f..f46da787b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pop-up @@ -13,14 +14,14 @@ Don’t use as a noun. For example, don't use *a pop-up;* use *a pop-up window* Don't use *pop up* or *pops up* as a verb to describe the appearance of a window. Use *open* or a similar verb instead. -It’s OK to use *pop-up window* to refer to windows that pop up in Help. Don’t use *pop-up window* as a synonym for *dialog box*. +It’s OK to use *pop-up window* to refer to windows that pop up in Help. Don’t use *pop-up window* as a synonym for *dialog*. It’s OK to use *pop-up menu* for a programming audience to describe the menu that appears when a customer right-clicks an item. If you must use a term to describe this type of menu in content for a general audience, use *shortcut menu*. **Examples** Answer the questions in the wizard as they appear. -Some commands carry out an action immediately. Others open a dialog box so that you can select options. +Some commands carry out an action immediately. Others open a dialog so that you can select options. A pop-up window gives additional information about an option. If you want to print the information in a pop-up window, right-click the window, and then select **Print Topic**. In the pop-up list, select **Microsoft Excel**. 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 2831234da..54ce6eb42 100644 --- a/styleguide/a-z-word-list-term-collections/p/port.md +++ b/styleguide/a-z-word-list-term-collections/p/port.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # port 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 452b7f73b..20149641d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # postal code 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 cbeeb3618..517652b14 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pound key, pound sign (\#) 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 e4d2efc70..92c472bc9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # power cord 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 6e9e84d46..097bba42e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # power down, power up, power off, power on 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 ac7fa2d53..46a12815e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # power user 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 c8f10da53..9f085478c 100644 --- a/styleguide/a-z-word-list-term-collections/p/pre.md +++ b/styleguide/a-z-word-list-term-collections/p/pre.md @@ -1,14 +1,15 @@ --- 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.prod: non-product-specific +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). 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 b146074f0..6b9d6407c 100644 --- a/styleguide/a-z-word-list-term-collections/p/preceding.md +++ b/styleguide/a-z-word-list-term-collections/p/preceding.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # preceding 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 4b95acb96..f4b7d8e45 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # press, press and hold 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 a8abd4bad..8e4637041 100644 --- a/styleguide/a-z-word-list-term-collections/p/preview.md +++ b/styleguide/a-z-word-list-term-collections/p/preview.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # preview 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 db8bc0e4e..eda0063c2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # print, printout 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 3f11d09f3..b8776c893 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # print queue, printer queue 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 53c514340..0e7efbb2a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # private cloud, hosted private cloud 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 c52259660..e7d2a67c1 100644 --- a/styleguide/a-z-word-list-term-collections/p/privileges.md +++ b/styleguide/a-z-word-list-term-collections/p/privileges.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # privileges 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 28ac1f256..77b931de4 100644 --- a/styleguide/a-z-word-list-term-collections/p/profile.md +++ b/styleguide/a-z-word-list-term-collections/p/profile.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # profile 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 7ad7cedf0..fda7e773b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # program file 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 2f264c390..09c3a0c22 100644 --- a/styleguide/a-z-word-list-term-collections/p/program.md +++ b/styleguide/a-z-word-list-term-collections/p/program.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # program 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 af4cc6a0c..f840a389a 100644 --- a/styleguide/a-z-word-list-term-collections/p/prompt.md +++ b/styleguide/a-z-word-list-term-collections/p/prompt.md @@ -1,23 +1,34 @@ --- -title: prompt - Microsoft Style Guide +title: prompt, prompting - Microsoft Style Guide +description: Describes how to use the term "prompt" in Microsoft content and how to create better prompts. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 07/09/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# prompt +# prompt, prompting -Use -only to describe a signal, which might or might not be a -message, that an app or the operating system is waiting for the customer -to take some action. In general, restrict the use of *prompt* as a noun to the command prompt. +The process of instructing an AI to do a task is called *prompting*. We tell the AI a set of instructions (the prompt) and it performs the task. Prompts can be as simple as a question, or as complex as context, instructions, and multiple examples. Prompts can contain prompts, sometimes referred to as prompt chaining. -Use as a verb to describe the act of requesting information or an action from the customer. +**Guidelines** -**Examples** -If you see a message that more information is needed .... -When you run Setup, you're prompted to select settings and file locations. +Focus on outcomes: Tell the user how to describe what they want to achieve their desired results, and include clear, relevant examples. + +Avoid using *prompt* as a noun within product UI, as in "Write your prompt." Instead, use request as in "Try a different request." + +Avoid using *prompt* as a noun phrase, as in "prompt field." + +Do not use *prompt* as a verb, as in "Then prompt Copilot to write your reply." + +**Learn prompting** +If you want quality outputs, you need fine-tuned prompts. To start becoming a prompting pro, check out this [prompt crafting guide](https://writer.com/guides/prompt-crafting/#:~:text=Prompt%20crafting%20%5B%E2%80%98prahmpt%20kraft-ing%E2%80%99%5D%20The%20art%20of%20succinctly,ideation%20and%20planning%20to%20production%2C%20repurposing%2C%20and%20distribution) (for marketing content) from Writer.com. Additional guidance we like: + +[Prompts for communicators using the new AI-powered Bing - The Official Microsoft Blog](https://blogs.microsoft.com/blog/2023/03/16/prompts-for-communicators-using-the-new-ai-powered-bing/) + +[LearnPrompting.org](https://learnprompting.org/) + +[Resources to learn prompting](https://learnprompting.org/docs/additional) **See also** [command prompt](~/a-z-word-list-term-collections/c/command-prompt.md) 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 05738ffee..7300e5e54 100644 --- a/styleguide/a-z-word-list-term-collections/p/prop.md +++ b/styleguide/a-z-word-list-term-collections/p/prop.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # prop 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 628ade343..6fbc6fec5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # property sheet, property page 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 c0bd517e4..103fa90d7 100644 --- a/styleguide/a-z-word-list-term-collections/p/property.md +++ b/styleguide/a-z-word-list-term-collections/p/property.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # property 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 e8c62a386..8d6bbf8ad 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # protected mode 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 991876967..4c717e9b6 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # public cloud 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 64a424e6a..0abdbd8b2 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,10 +1,11 @@ --- 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: 05/17/2018 +ms.date: 04/01/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # pull down, pull-down @@ -19,6 +20,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) 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 690e01139..e57705c76 100644 --- a/styleguide/a-z-word-list-term-collections/p/purge.md +++ b/styleguide/a-z-word-list-term-collections/p/purge.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # purge 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 dfbb1ad1f..f04c426af 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # push button, push-button 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 5672f61f5..3569faa0e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # quality, high-quality 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 ae34fe722..45936bd9b 100644 --- a/styleguide/a-z-word-list-term-collections/q/quit.md +++ b/styleguide/a-z-word-list-term-collections/q/quit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # quit 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 eb930a6be..570de2206 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # radio button 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 d77f4a4ca..f1c9d950a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ragged right 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 c88194d30..1a8be8115 100644 --- a/styleguide/a-z-word-list-term-collections/r/ram.md +++ b/styleguide/a-z-word-list-term-collections/r/ram.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # RAM 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 1fc4cfe9b..9dba8bdf3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # range selection 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 7ffd3a292..35a87f54a 100644 --- a/styleguide/a-z-word-list-term-collections/r/re.md +++ b/styleguide/a-z-word-list-term-collections/r/re.md @@ -1,15 +1,16 @@ --- 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.prod: non-product-specific +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 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 a98c05019..134e3dae7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # read-only 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 498a29c00..20a1875d9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # read/write, read/write permission 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 1ec1656b3..2a0997b2c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # real time, real-time 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 fd6cb2a14..fc1c6ee99 100644 --- a/styleguide/a-z-word-list-term-collections/r/reboot.md +++ b/styleguide/a-z-word-list-term-collections/r/reboot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # reboot 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 6dcc20a29..5b32037af 100644 --- a/styleguide/a-z-word-list-term-collections/r/recommend.md +++ b/styleguide/a-z-word-list-term-collections/r/recommend.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # recommend 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 f73bd0c27..76ba3120c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Recycle Bin, recycle bin 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 058d6c8ba..a22855373 100644 --- a/styleguide/a-z-word-list-term-collections/r/refresh.md +++ b/styleguide/a-z-word-list-term-collections/r/refresh.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # refresh 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 00ab8bcb8..c6b809426 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # registry, registry settings 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 d7767acb2..8c81037fa 100644 --- a/styleguide/a-z-word-list-term-collections/r/reinitialize.md +++ b/styleguide/a-z-word-list-term-collections/r/reinitialize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # reinitialize 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 3e51a373b..c12ab30bd 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # relationship chatbot 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 b22ccaea2..9e65a53c8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # REM statement 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 0be904343..41b74bda1 100644 --- a/styleguide/a-z-word-list-term-collections/r/remote.md +++ b/styleguide/a-z-word-list-term-collections/r/remote.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # remote 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 9213b6ed3..b1ecf1f27 100644 --- a/styleguide/a-z-word-list-term-collections/r/remove.md +++ b/styleguide/a-z-word-list-term-collections/r/remove.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # remove 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 925837211..be18cef3d 100644 --- a/styleguide/a-z-word-list-term-collections/r/replace.md +++ b/styleguide/a-z-word-list-term-collections/r/replace.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # replace 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 5f0164977..93f537bac 100644 --- a/styleguide/a-z-word-list-term-collections/r/restart.md +++ b/styleguide/a-z-word-list-term-collections/r/restart.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # restart 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 fe9a92f9d..d3985af75 100644 --- a/styleguide/a-z-word-list-term-collections/r/restore.md +++ b/styleguide/a-z-word-list-term-collections/r/restore.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # restore 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 a5cc85678..f6b6c799c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # reverse video 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 71c2b3986..b6e3188c9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # right align, right-aligned 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 f4777baa7..d8276c59f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # right-click 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 58d866bad..6a64dcc0a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # right justify, right-justified 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 aab5c35ac..38769264b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # right mouse button 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 1da736992..377a4228e 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # right, rightmost, right-hand 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 357c02bca..66488a790 100644 --- a/styleguide/a-z-word-list-term-collections/r/rights.md +++ b/styleguide/a-z-word-list-term-collections/r/rights.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # rights 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 d3b3da673..338769929 100644 --- a/styleguide/a-z-word-list-term-collections/r/rom.md +++ b/styleguide/a-z-word-list-term-collections/r/rom.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ROM 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 e316dad49..033219871 100644 --- a/styleguide/a-z-word-list-term-collections/r/roman.md +++ b/styleguide/a-z-word-list-term-collections/r/roman.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Roman 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 86e827c8a..7a058a987 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # root directory 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 2eb36b11a..4d1df6275 100644 --- a/styleguide/a-z-word-list-term-collections/r/rotate.md +++ b/styleguide/a-z-word-list-term-collections/r/rotate.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # rotate 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 d42e8bf98..f69dfd397 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # run vs. execute 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 bb148fa04..855d9ac0f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # running foot, running head 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 327a4352f..d29ced180 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # runs vs. runs on 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 b69613d81..253986f27 100644 --- a/styleguide/a-z-word-list-term-collections/r/runtime.md +++ b/styleguide/a-z-word-list-term-collections/r/runtime.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # runtime 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 1c153ea1b..c2098ce1f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # (s), (es) 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 a8d8edfea..85bd03011 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # sample vs. preview 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 8fc6af1fc..c83a01451 100644 --- a/styleguide/a-z-word-list-term-collections/s/save.md +++ b/styleguide/a-z-word-list-term-collections/s/save.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # save 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 5d0207970..dfa1defc6 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # scan line 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 6f4c6fed8..cfb46fc0d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # screen resolution 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 a540848ae..4e57499b4 100644 --- a/styleguide/a-z-word-list-term-collections/s/screen.md +++ b/styleguide/a-z-word-list-term-collections/s/screen.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # screen 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 4f391a403..b2177d662 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # screened subnet 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 acedfb0f8..ad9a9bc72 100644 --- a/styleguide/a-z-word-list-term-collections/s/screenshot.md +++ b/styleguide/a-z-word-list-term-collections/s/screenshot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # screenshot 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 edfd6aa60..0f6156802 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # script, scriptlet 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 08a408722..35d8e08b9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # scroll bar, scroll arrow, scroll box 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 d4ce66c03..c0e16c56d 100644 --- a/styleguide/a-z-word-list-term-collections/s/scroll.md +++ b/styleguide/a-z-word-list-term-collections/s/scroll.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # scroll 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 1a9d2aaff..3bdb01aa7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # search, search and replace 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 ca54b0723..a0291754f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # search box 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 c24cd75b5..8e94dbbe7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # secondary menu diff --git a/styleguide/a-z-word-list-term-collections/s/see-see-also-and-similar-phrases.md b/styleguide/a-z-word-list-term-collections/s/see-see-also-and-similar-phrases.md new file mode 100644 index 000000000..bdfe05dc0 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/s/see-see-also-and-similar-phrases.md @@ -0,0 +1,15 @@ +--- +title: see, see also, and similar phrases - Microsoft Style Guide +description: This article outlines the use of expressions related to vision per Microsoft style guidelines. +author: pallep +ms.author: pallep +ms.date: 02/26/2024 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# see, see also, and similar phrases + +Phrases like *see*, *see also*, *view*, *view all*, and *watch it later* are fine to use from an inclusive design perspective, as long as they're being used in contexts that otherwise support accessibility. The problem is when we use that language and then fail to provide a way for the person to consume the content. + +See [Accessibility guidelines and requirements](https://learn.microsoft.com/en-us/style-guide/accessibility/accessibility-guidelines-requirements) for more information about creating products and content that are accessible to people of all abilities. 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 512044fa2..cb0346c73 100644 --- a/styleguide/a-z-word-list-term-collections/s/select.md +++ b/styleguide/a-z-word-list-term-collections/s/select.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # select 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 c5c00ee05..131e3f35d 100644 --- a/styleguide/a-z-word-list-term-collections/s/server.md +++ b/styleguide/a-z-word-list-term-collections/s/server.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # server 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 c9cb36ad1..6fb3b2f13 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 301cc07da..a79061d89 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # service-oriented architecture (SOA) 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 5e89b1a25..0c5ae5f10 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,10 +1,11 @@ --- title: set, specify - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # set, specify 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 4ca8e3a46..5818648df 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # set-top box 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 e24a23cb2..0917d561d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # set up, setup, Setup 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 4bdb150ca..a017e51e8 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # setting, value 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 3dba87753..03cc77df7 100644 --- a/styleguide/a-z-word-list-term-collections/s/shaded.md +++ b/styleguide/a-z-word-list-term-collections/s/shaded.md @@ -1,10 +1,11 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # shaded @@ -13,7 +14,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. 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 375e5515f..28425acbd 100644 --- a/styleguide/a-z-word-list-term-collections/s/shell.md +++ b/styleguide/a-z-word-list-term-collections/s/shell.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # shell 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 418990d1d..25715a0a2 100644 --- a/styleguide/a-z-word-list-term-collections/s/ship.md +++ b/styleguide/a-z-word-list-term-collections/s/ship.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ship 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 73f4f8b75..1b7b533d9 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,15 +1,16 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # shortcut, shortcut menu -*Shortcut* is one word as an adjective or a noun. Don't use as a verb. Don't use as a synonym for *hyperlink.* +*Shortcut* is one word as an adjective or a noun. Don't use as a verb. Don't use as a synonym for *link.* Use *shortcut menu* only if it helps the customer locate the item in the UI. Most of the time, just describe what the customer needs to do. 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 9a8f05397..137d6c01f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # should vs. must 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 c20a83cd0..9cac28389 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # shut down, shutdown 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 190744b3f..429f51a5a 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,10 +1,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # sign in, sign out @@ -22,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) 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 6a476795e..3d2b80cc0 100644 --- a/styleguide/a-z-word-list-term-collections/s/simply.md +++ b/styleguide/a-z-word-list-term-collections/s/simply.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # simply 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 a7b704e04..5de762f1f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # single sign-on (SSO) 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 96f3b8ce8..4249ef66d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # site map 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 7f431d169..c01580c5b 100644 --- a/styleguide/a-z-word-list-term-collections/s/site.md +++ b/styleguide/a-z-word-list-term-collections/s/site.md @@ -1,10 +1,11 @@ --- title: site - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # site 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 f154f5265..51d98a58f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # size, resize 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 409154751..7ff20d181 100644 --- a/styleguide/a-z-word-list-term-collections/s/sleep.md +++ b/styleguide/a-z-word-list-term-collections/s/sleep.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # sleep 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 e02330573..031f1d088 100644 --- a/styleguide/a-z-word-list-term-collections/s/slider.md +++ b/styleguide/a-z-word-list-term-collections/s/slider.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # slider @@ -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. -![](media/slider/1637616098.png) +![Screenshot of a cursor thickness slider with an image to the left of the slider showing how thick a cursor will be at the selected setting.](media/slider/1637616098.png) 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/slideshow.md b/styleguide/a-z-word-list-term-collections/s/slideshow.md index b8887269e..640f208e1 100644 --- a/styleguide/a-z-word-list-term-collections/s/slideshow.md +++ b/styleguide/a-z-word-list-term-collections/s/slideshow.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # slideshow 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 429df62f7..87c438708 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # small caps 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 df281b991..2c24f68b3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # smart card, Smart Card 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 239a79d87..0cacf032f 100644 --- a/styleguide/a-z-word-list-term-collections/s/smartphone.md +++ b/styleguide/a-z-word-list-term-collections/s/smartphone.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # smartphone 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 000000000..25b2984c6 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/s/smb.md @@ -0,0 +1,13 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# SMB + +Avoid using the acronym *SMB*. Use *small or medium-sized business* instead. 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 39b276413..55f1711c3 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # snap-in 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 e5e20d737..c1d177cfe 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # social chatbot 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 8f807d8a0..01643c11d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # soft copy 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 18665fd69..0a6bbde38 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # software as a service (SaaS) 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 196ea6439..bf2f66e54 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # software-plus-services 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 f54b4adcd..623218eb2 100644 --- a/styleguide/a-z-word-list-term-collections/s/sorry.md +++ b/styleguide/a-z-word-list-term-collections/s/sorry.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # sorry 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 0407aa1f0..12fecb0de 100644 --- a/styleguide/a-z-word-list-term-collections/s/spam.md +++ b/styleguide/a-z-word-list-term-collections/s/spam.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spam 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 62aed19af..aa90ee9a5 100644 --- a/styleguide/a-z-word-list-term-collections/s/specification.md +++ b/styleguide/a-z-word-list-term-collections/s/specification.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # specification 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 c9b137d46..d092475b9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spell checker 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 c9ed60ea2..39c6be0c0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spin box @@ -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. -![](media/spin-box/63270893.jpg) +![Screenshot of the Duration field which has a clock icon next to it and a text field with arrows to set the desired value.](media/spin-box/63270893.jpg) 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 fd3f8021a..ae3626c6b 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,14 +1,15 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # split bar, split box -![](media/split-bar-split-box/1404636417.png) +![Screenshot of the split bar and split box icon as it appears when hovering over a bar or box that can be split.](media/split-bar-split-box/1404636417.png) 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/spoofing.md b/styleguide/a-z-word-list-term-collections/s/spoofing.md index 77abbdb19..72926e858 100644 --- a/styleguide/a-z-word-list-term-collections/s/spoofing.md +++ b/styleguide/a-z-word-list-term-collections/s/spoofing.md @@ -1,10 +1,11 @@ --- title: spoofing - Microsoft Style Guide +description: Describes guidelines to use 'spoofing' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spoofing 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 3c39f1553..4946aea7a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spreadsheet vs. workbook 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 f63011057..244ce190f 100644 --- a/styleguide/a-z-word-list-term-collections/s/spyware.md +++ b/styleguide/a-z-word-list-term-collections/s/spyware.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # spyware 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 fe4871bce..82344e215 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,21 +1,21 @@ --- 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: 01/19/2018 +ms.date: 12/09/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # SQL, SQL Server 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. 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 c44810928..30e20d166 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Start button, Start menu @@ -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 ![](media/start-button-start-menu/967781121.png) -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 ![](media/start-button-start-menu/967781121.png) 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/start-page.md b/styleguide/a-z-word-list-term-collections/s/start-page.md index 61995a7c5..6d31a9e46 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # start page 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 298296485..ef0f9d6e4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # start, restart 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 9a82c031b..cad9b19df 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # start up, startup 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 231bb8337..6bfe9acb1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # status bar @@ -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. -![](media/status-bar/1622172745.png) +![Screenshot of a progress bar for downloading the Childcare Policies document file with an icon to cancel the download.](media/status-bar/1622172745.png) -![](media/status-bar/1474851511.png) +![Screenshot of the bottom of a document window that shows the currently displayed page, section, line, and column.](media/status-bar/1474851511.png) **Example** The page number is displayed on the status bar. 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 b914fb348..5a15a4686 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # stop, stop responding 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 982f725b7..1b084caef 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,14 +1,17 @@ --- -title: storage, storage device - Microsoft Style Guide +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.prod: non-product-specific +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. 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 8008039fb..91403a946 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # store, marketplace, gallery 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 5090959ae..b1d4c2f09 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # stream, streaming 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 e4057bf78..17899617b 100644 --- a/styleguide/a-z-word-list-term-collections/s/stretch.md +++ b/styleguide/a-z-word-list-term-collections/s/stretch.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # stretch 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 683c2a262..a99fe8491 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # struct, structure 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 5963a5db6..aaae1aeea 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # style sheet 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 c5ced0231..db9d48ca0 100644 --- a/styleguide/a-z-word-list-term-collections/s/sub.md +++ b/styleguide/a-z-word-list-term-collections/s/sub.md @@ -1,14 +1,15 @@ --- 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.prod: non-product-specific +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). 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 9e9fed683..755b1ee30 100644 --- a/styleguide/a-z-word-list-term-collections/s/subaddress.md +++ b/styleguide/a-z-word-list-term-collections/s/subaddress.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # subaddress 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 42eb45938..59097d65c 100644 --- a/styleguide/a-z-word-list-term-collections/s/subclass.md +++ b/styleguide/a-z-word-list-term-collections/s/subclass.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # subclass 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 7a5cbe95c..e5df1d024 100644 --- a/styleguide/a-z-word-list-term-collections/s/surf.md +++ b/styleguide/a-z-word-list-term-collections/s/surf.md @@ -1,10 +1,11 @@ --- title: surf - Microsoft Style Guide +description: Describes guidelines to use 'surf' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # surf 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 4bc827bd7..fd3bdb631 100644 --- a/styleguide/a-z-word-list-term-collections/s/swipe.md +++ b/styleguide/a-z-word-list-term-collections/s/swipe.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # swipe 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 5c8b14002..758dab372 100644 --- a/styleguide/a-z-word-list-term-collections/s/switch.md +++ b/styleguide/a-z-word-list-term-collections/s/switch.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # switch 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 453efeb01..7d0002af4 100644 --- a/styleguide/a-z-word-list-term-collections/s/symbol.md +++ b/styleguide/a-z-word-list-term-collections/s/symbol.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # symbol @@ -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. <br />**Examples**<br />Select the **Minimize** button (![](media/symbol/1689948149.PNG)).<br />Select ![](media/symbol/1414490202.PNG). + definition. <br />**Examples**<br />Select the **Minimize** button (![Screenshot of a gray square with a subtraction icon to indicate a screen can be minimized.](media/symbol/1689948149.PNG)).<br />Select ![Screenshot of a gray square with a black X to indicate that a screen can be closed.](media/symbol/1414490202.PNG). - Write out the plurals of symbols, showing the use in parentheses. Don't add *s* or *'s* to a symbol. <br />**Example** <br />Enter two backslashes (\\\\) to show a network connection. 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 735b3c4f2..b981175fc 100644 --- a/styleguide/a-z-word-list-term-collections/s/sync.md +++ b/styleguide/a-z-word-list-term-collections/s/sync.md @@ -1,10 +1,11 @@ --- title: sync - Microsoft Style Guide +description: Describes guidelines to use 'sync' in Microsoft documents. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # sync 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 79e89c518..ce66084e1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # system administrator 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 3cc23e3a8..db6f1614b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # system prompt 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 af9a4e5ee..b6e7fb81f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # system software 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 340cbabac..055f6e2b5 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,14 +1,17 @@ --- title: system tray - Microsoft Style Guide +description: Describes guidelines to use 'system tray' in Microsoft documents, and provides a link to a related term. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 12/22/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # system tray -Don't use. Use *notification area* instead. +In Windows 11, use to refer to the area on the taskbar where the clock and system notifications appear. + +In earlier versions of Windows, this UI element was referred to as the *notification area*. **See also** [notification area](~/a-z-word-list-term-collections/n/notification-area.md) 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 82868add8..3744e62eb 100644 --- a/styleguide/a-z-word-list-term-collections/t/tab.md +++ b/styleguide/a-z-word-list-term-collections/t/tab.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tab 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 39f6eead1..1f0b976bf 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # table of contents 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 c5d45d633..133d63144 100644 --- a/styleguide/a-z-word-list-term-collections/t/tablet.md +++ b/styleguide/a-z-word-list-term-collections/t/tablet.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tablet 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 0810edaf5..c5e36d284 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tap, double-tap, tap and hold 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 f57c49bf1..db5f310f1 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # target drive, target file 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 e3476e344..7966dedb7 100644 --- a/styleguide/a-z-word-list-term-collections/t/taskbar.md +++ b/styleguide/a-z-word-list-term-collections/t/taskbar.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # taskbar 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 e2ceb4c26..95d110120 100644 --- a/styleguide/a-z-word-list-term-collections/t/terabyte.md +++ b/styleguide/a-z-word-list-term-collections/t/terabyte.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # terabyte, TB 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 4ba0db712..207da6b80 100644 --- a/styleguide/a-z-word-list-term-collections/t/terminate.md +++ b/styleguide/a-z-word-list-term-collections/t/terminate.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # terminate 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 52ac108f0..c73b08869 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # text box 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 5612a63e4..5f58fa5d2 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # text, text message 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 9739a86d3..36e6d7436 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # thanks, thank you 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 3d0fbbd62..baf6c9f6a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # that vs. which 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 10ba72b95..7ea17f20f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # thousand, K 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 eebb6977f..70aca405a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tile, Live Tile 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 6ecfb8f8c..d2a989232 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # time out, time-out 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 3623bcf26..87a0f58eb 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # time stamp 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 b701e0344..f0632ebe5 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # to-do 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 50b99c191..37b744960 100644 --- a/styleguide/a-z-word-list-term-collections/t/toast.md +++ b/styleguide/a-z-word-list-term-collections/t/toast.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # toast 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 87830fa4e..c51b9426b 100644 --- a/styleguide/a-z-word-list-term-collections/t/toggle.md +++ b/styleguide/a-z-word-list-term-collections/t/toggle.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # toggle 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 e66b19990..14d9f3fb8 100644 --- a/styleguide/a-z-word-list-term-collections/t/tone.md +++ b/styleguide/a-z-word-list-term-collections/t/tone.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tone 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 59c5d180c..e3ca5e269 100644 --- a/styleguide/a-z-word-list-term-collections/t/tool.md +++ b/styleguide/a-z-word-list-term-collections/t/tool.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # tool 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 533e1fa03..cba045c66 100644 --- a/styleguide/a-z-word-list-term-collections/t/toolkit.md +++ b/styleguide/a-z-word-list-term-collections/t/toolkit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # toolkit 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 bc8c6c1b4..70324c66b 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # top left, top right 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 06d87144f..87b1dfe25 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # top-level folder 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 000000000..0432f9f81 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/t/touch-sensitive.md @@ -0,0 +1,13 @@ +--- +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 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# touch-sensitive + +Always hyphenate. 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 88a0bfd79..a8a8643c0 100644 --- a/styleguide/a-z-word-list-term-collections/t/touchpad.md +++ b/styleguide/a-z-word-list-term-collections/t/touchpad.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # touchpad 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 91143003e..2edf7b1e3 100644 --- a/styleguide/a-z-word-list-term-collections/t/touchscreen.md +++ b/styleguide/a-z-word-list-term-collections/t/touchscreen.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # touchscreen 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 9266d14c6..fa33794df 100644 --- a/styleguide/a-z-word-list-term-collections/t/toward.md +++ b/styleguide/a-z-word-list-term-collections/t/toward.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # toward 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 4e62b51ef..f67f0e4df 100644 --- a/styleguide/a-z-word-list-term-collections/t/trackball.md +++ b/styleguide/a-z-word-list-term-collections/t/trackball.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # trackball 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 f283d0cc1..10b49b6d3 100644 --- a/styleguide/a-z-word-list-term-collections/t/trailing.md +++ b/styleguide/a-z-word-list-term-collections/t/trailing.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # trailing 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 24faf5119..5f434c356 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # trojan horse, trojan 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 9b4f37632..9d7e57491 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,29 +1,29 @@ --- 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: 01/19/2018 +ms.date: 05/22/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # turn on, turn off 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. +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) 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 4cc762a6f..0db0a06fc 100644 --- a/styleguide/a-z-word-list-term-collections/t/turnkey.md +++ b/styleguide/a-z-word-list-term-collections/t/turnkey.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # turnkey 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 206dc7547..93e74f03d 100644 --- a/styleguide/a-z-word-list-term-collections/t/type.md +++ b/styleguide/a-z-word-list-term-collections/t/type.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # type 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 99eb8b782..8f96eb293 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,44 +1,38 @@ --- 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: 05/09/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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**<br /> -Person with visual impairment, person who is blind<br /> -Person with hearing loss, person with deafness<br /> -Person who is nonverbal, person who uses sign language<br /> -Person who uses a wheelchair<br /> -Person with a prosthetic limb, person without a limb<br /> -Person with autism<br /> -Person of small stature<br /> +In all cases, don’t use language that has offensive or insensitive connotations, such as *maimed* or *impaired*. -If necessary, use the following terms to describe people with disabilities or the disabilities themselves. +The following table lists examples of people-first language (preferred), identity-first language (acceptable, context-dependent), and offensive or insensitive language (never allowed). -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. + | **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 | +| 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, special needs | +| Person with autism | Autistic person, neurodivergent person | Asperger’s | +| functional needs (or paraphrase according to the specific disability) | | special needs | -| **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 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. 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 8c323c398..ff6d792b3 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,15 +1,16 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # AI and bot terms -In general, avoid talking about AI and bot technology. Instead, focus on the benefits of the technology or what the customer wants to do with it. When it's necessary to talk about the technology itself—such as in content for developers or in event presentations, or to make it clear that the customer is chatting with a bot, not a person—use the terms below. +Avoid talking about AI and bot technology. Instead, focus on the benefits of the technology or what the customer wants to do with it. When it's necessary to talk about the technology itself—such as in content for developers or in event presentations, or to make it clear that the customer is chatting with a bot, not a person—use the terms below. Before you invent a term, make sure a suitable term doesn't already exist. For more information about creating new terms or using emerging terminology, see [Use technical terms carefully](~/word-choice/use-technical-terms-carefully.md). @@ -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.<br /><br />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.*<br /><br />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.<br /><br />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.<br /><br />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.*<br /><br />Don't hyphenate *conversation as a platform* when used as a modifier. | | **conversational user interface (CUI)** | Avoid the term in customer-facing communications.<br /><br />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.<br /><br />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.<br /><br />In UI, use *intelligent technology* to describe the underlying technology that powers AI features.<br /><br />Don't use *smart technology.*<br /><br />**Examples**<br />To help people do their best work, Microsoft is making AI available to everyone by building intelligent features into our core products.<br />Enhance your sales performance and planning with intelligent applications like Microsoft Dynamics 365 AI for Sales.<br />From document translation to intelligent threat detection, AI is enhancing the productivity of more than 120 million commercial Office 365 users.<br />![](media/intelligent-feature-example.png) | +| **intelligent, intelligence, intelligent technology** | For all audiences and in most content, use *intelligent* or *intelligence* to describe or talk about the benefits of AI.<br /><br />In UI, use *intelligent technology* to describe the underlying technology that powers AI features.<br /><br />Don't use *smart technology.*<br /><br />**Examples**<br />To help people do their best work, Microsoft is making AI available to everyone by building intelligent features into our core products.<br />Enhance your sales performance and planning with intelligent applications like Microsoft Dynamics 365 AI for Sales.<br />From document translation to intelligent threat detection, AI is enhancing the productivity of more than 120 million commercial Office 365 users.<br />![Screenshot of a What's New in PowerPoint notification with entries reading Present in multiple languages and Convert S V G icons to shapes.](media/intelligent-feature-example.png) | | **Microsoft AI** | Use only to refer to the initiative that Microsoft is undertaking to accelerate AI capabilities and infuse intelligence into our offerings.<br /><br />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.<br /><br />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/bits-bytes-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md index 6744a4a95..33caea12f 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,10 +1,11 @@ --- 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: 01/19/2018 +ms.date: 03/31/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Bits and bytes terms @@ -44,20 +45,20 @@ 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.* | -| **byte** | *None* | Don't abbreviate. | +| **byte** | *None* | Don't abbreviate, unless in UI. | | **exabyte** | EB | Don’t use *E, E byte,* or *EByte.* | -| **gigabit** | *None* | Don’t abbreviate. | +| **gigabit** | *None* | Don’t abbreviate, unless in UI. | | **gigabits per second** | Gbps | Don't spell out as *Gb per second*. | | **gigabyte** | GB | Don’t use *G, G byte,* or *GByte*. | -| **kilobit** | *None* | Don’t abbreviate. | +| **kilobit** | *None* | Don’t abbreviate, unless in UI. | | **kilobits per second** | Kbps | Don't spell out as *KB per second*. | | **kilobyte** | KB | Don't use *K, K byte,* or *KByte*. | | **kilobytes per second** | KBps | Don't spell out as *KB per second*. | -| **megabit** | *None* | Don’t abbreviate. | +| **megabit** | *None* | Don’t abbreviate, unless in UI. | | **megabits per second** | Mbps | Don't spell out as *Mb per second*. | | **megabyte** | MB | Don’t use *M, meg, M byte,* or *MByte*. | | **megabytes per second** | MBps | Don't spell out as *MB per second*. | 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 463336830..e830f98d7 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,10 +1,11 @@ --- 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: 04/8/2019 +ms.date: 12/13/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Cloud-computing terms @@ -20,24 +21,30 @@ 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 | |-------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **cloud** | Don't capitalize. Don't use *Microsoft Cloud* or *the Cloud.*<br /><br />Use *cloud* mostly as an adjective. Use sparingly as a noun *(the cloud).*<br /><br />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.<br /><br />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.<br /><br />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.<br /><br />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.<br /><br />Use *cloud platform* only in content for a technical audience, such as content about Azure.<br /><br />Use *cloud services* to refer to the services provided via the cloud—such as servers, storage, databases, and software.<br /><br />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.<br /><br /> Lowercase. Hyphenate *cloud-native* as an adjective preceding a noun, as in *cloud-native app*. Don’t hyphenate in other instances.<br /><br />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.<br /><br />Lowercase.<br /><br />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.<br /><br />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.<br /><br />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.<br /><br />Spell out on the first mention. After that, it's OK to use *IaaS.* <br /><br />Don't capitalize as *IAAS.*<br /><br />Don't hyphenate as a modifier, but include the abbreviated form in parentheses.<br /><br />**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.<br /><br />In content for a general audience, refer to the specific type of service, such as applying software updates, in a cloud-computing model.<br /><br />Spell out on the first mention. After that, it's OK to use *ITaaS*. <br /><br />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. <br /><br />Always lowercase *cloud* and *platform*.<br /><br />After the first mention, it's OK to use *cloud platform.*<br /><br />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.<br /><br />Always lowercase *cloud* and *services*.<br /><br />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.<br /><br />It’s OK to use *IaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.<br /><br />Don't capitalize as *IAAS.*<br /><br />Don't hyphenate as a modifier. | +| **IT as a service (ITaaS)** | Use for technical or business-decision-maker audiences only.<br /><br />In content for a general audience, refer to the specific type of service, such as applying software updates, in a cloud-computing model.<br /><br />It’s OK to use *ITaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.<br /><br />Don't capitalize as *ITAAS*.<br /><br />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.<br /><br />When used in this meaning, *Microsoft Cloud* is capitalized.<br /><br />Include the article (*the*) before *Microsoft Cloud*.<br /><br />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.<br /><br />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*.<br /><br />One word, no hyphen. | | **on-premises, off-premises** | Hyphenate in all positions. <br /><br />*Premises* is plural. Don't use *on-premise*, *off-premise*. <br /><br />Don't use *on-premises cloud* or *off-premises cloud.* | -| **platform as a service (PaaS)** | Use for technical audiences only. <br /><br />Spell out on the first mention. After that, it's OK to use *PaaS*. <br /><br />Don't capitalize as *PAAS*.<br /><br />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. <br /><br />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. <br /><br />Don't capitalize as *SAAS*.<br /><br />Don't hyphenate as a modifier, but include the abbreviated form in parentheses. | +| **platform as a service (PaaS)** | Use for technical audiences only. <br /><br />It’s OK to use *PaaS* after the term has been spelled out on the first mention with the abbreviated form in parentheses.<br /><br />Don't capitalize as *PAAS*.<br /><br />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.<br /><br />Don't capitalize as *SAAS*.<br /><br />Don't hyphenate as a modifier. | 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 30ff8d1cd..52c59882c 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Computer and device terms @@ -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. <br /><br />Use *mobile device* only when you need to call out the mobility.<br /><br />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.<br /><br />It's OK to use *PC* when space is a constraint, but don't switch between *PC* and *computer*.<br /><br />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 964641010..50e36cb7f 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,10 +1,11 @@ --- 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: 04/4/2019 +ms.date: 05/09/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Date and time terms @@ -12,15 +13,15 @@ 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*.<br />**Examples**<br />10:45 AM<br />6:30 PM | +| **AM, PM** | Use *AM* and *PM* (preceded by a space). Use capital letters for *AM* and *PM*.<br />**Examples**<br />10:45 AM<br />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*.<br /><br />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.<br /><br />Don't use ordinal numbers (such as 1st, 12th, or 23rd) to indicate a date.<br />**Examples**<br />February 16, 2016<br />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.<br /><br />Three-letter abbreviations are preferred:<br />*Sun, Mon, Tue, Wed, Thu, Fri,* and *Sat*<br /><br />In calendars and date picker UI controls, it's OK to use two-letter or one-letter abbreviations:<br />*Su, Mo, Tu, We, Th, Fr,* and *Sa*<br />*S, M, T, W, T, F,* and *S*<br /><br />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*.<br /><br />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.<br /><br />Don't use abbreviations unless space is extremely limited. <br />Use three-letter abbreviations when necessary: <br />*Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,* and *Dec* <br />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.) <br /><br />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.) <br /><br />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*. <br /><br />Include the time zone if you're discussing an event that customers beyond the local time zone might see or attend. <br /><br />In text, use *to* in a range of times.<br />**Example** <br />10:00 AM to 2:00 PM <br /><br />In a schedule or listing, use an en dash with no spaces around it. <br />**Example** <br />10:00 AM–2:00 PM<br /><br />**Exception**<br />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. <br />**Examples**<br />2:15 AM–4:45 PM 4/1/16 (time range on a single day)<br />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*.<br /><br />Don't specify *standard time or daylight saving time* unless you're providing information about a specific event where that information matters.<br /><br />If you're referring to a time zone as a geographical area, call it a zone. <br />**Example** <br />in the Pacific Time zone <br /><br />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 (-).<br />**Examples**<br />Eastern Time (UTC-5)<br />Eastern Time (UTC+10)<br />Eastern Time (Australia)<br /><br />For time zones without names, refer to the offset from Coordinated Universal Time. <br />**Example** <br />UTC+7<br /><br />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*.<br /><br />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)*. | 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 a8f5f9af8..e95d2327d 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,10 +1,11 @@ --- 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: 05/10/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Keys and keyboard shortcuts @@ -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. <br />**Example**<br />Alt+Ctrl+S <br /><br />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. <br /><br />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. | @@ -61,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*. | 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 ea97f04e3..08b92b903 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,10 +1,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # Mouse and mouse interaction terms @@ -12,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. @@ -48,6 +49,6 @@ of the word *pointer*—use both<em>.</em> |**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 (<img src="media/mouse-mouse-interaction-terms/1502439723.png" />). Don't use *double-headed arrow* as a name for the pointer. <br />**Example**<br />When the pointer becomes a <img src="media/mouse-mouse-interaction-terms/270050385.png" />, 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. <br />**Example**<br />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/term-collections/security-terms.md b/styleguide/a-z-word-list-term-collections/term-collections/security-terms.md index 27282b16e..a6731906d 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Security terms @@ -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 724df3fa8..739dd4066 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Special characters 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 dde0546f4..815762fbb 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Touch and pen interaction terms @@ -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 93e40e6bc..baac3d8ee 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,10 +1,11 @@ --- 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: 03/12/2018 +ms.date: 08/09/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Units of measure terms @@ -76,6 +77,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|m<sup>2</sup>| +|**Volume**|cubic foot|cu ft| +||cubic meter|m<sup>3</sup>| |**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.<br /><br />It’s OK to abbreviate as *px* in content about online design when space is limited. <br /><br />**Examples**<br />48 × 48 px <br />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. <br /><br />**Examples**<br />72 pixels per inch <br />At 72 PPI, ….| 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 4b92f9d4c..38cfb9fc5 100644 --- a/styleguide/a-z-word-list-term-collections/u/uk.md +++ b/styleguide/a-z-word-list-term-collections/u/uk.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # UK 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 3cb8cf97f..b72a2f871 100644 --- a/styleguide/a-z-word-list-term-collections/u/ultrabook.md +++ b/styleguide/a-z-word-list-term-collections/u/ultrabook.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Ultrabook 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 206bc7649..2b972a1dd 100644 --- a/styleguide/a-z-word-list-term-collections/u/un.md +++ b/styleguide/a-z-word-list-term-collections/u/un.md @@ -1,14 +1,15 @@ --- 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.prod: non-product-specific +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). 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 57f57946c..a46388f7e 100644 --- a/styleguide/a-z-word-list-term-collections/u/unavailable.md +++ b/styleguide/a-z-word-list-term-collections/u/unavailable.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # unavailable 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 874a3b81e..5634e54d7 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,12 +1,13 @@ --- 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: 01/19/2018 +ms.date: 04/02/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # uncheck, unmark, unselect -Don't use to refer to clearing a check box. Use *clear* instead. +Don't use to refer to clearing a checkbox. Use *clear* instead. 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 4145e9ebf..0133b136d 100644 --- a/styleguide/a-z-word-list-term-collections/u/undelete.md +++ b/styleguide/a-z-word-list-term-collections/u/undelete.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # undelete 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 3608c13ad..a73d64bc0 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # underline vs. underscore 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 a7e2216df..845ed8909 100644 --- a/styleguide/a-z-word-list-term-collections/u/undo.md +++ b/styleguide/a-z-word-list-term-collections/u/undo.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # undo 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 2a9b8fd7f..35ea393d7 100644 --- a/styleguide/a-z-word-list-term-collections/u/uninstall.md +++ b/styleguide/a-z-word-list-term-collections/u/uninstall.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # uninstall 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 9ab2f61fc..feddfeb9d 100644 --- a/styleguide/a-z-word-list-term-collections/u/unregister.md +++ b/styleguide/a-z-word-list-term-collections/u/unregister.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # unregister 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 b908278fd..a8e5256f9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # unwanted software 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 67d2d5048..4bb3f6402 100644 --- a/styleguide/a-z-word-list-term-collections/u/upgrade.md +++ b/styleguide/a-z-word-list-term-collections/u/upgrade.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # upgrade 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 22a7f0b5d..261ac9cbc 100644 --- a/styleguide/a-z-word-list-term-collections/u/upload.md +++ b/styleguide/a-z-word-list-term-collections/u/upload.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # upload 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 9fdf34223..cda346212 100644 --- a/styleguide/a-z-word-list-term-collections/u/upnp.md +++ b/styleguide/a-z-word-list-term-collections/u/upnp.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # UPnP 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 f4445e6f6..7d6f634ff 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # upper left, upper right 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 cb7b4740c..81a5fefec 100644 --- a/styleguide/a-z-word-list-term-collections/u/uppercase.md +++ b/styleguide/a-z-word-list-term-collections/u/uppercase.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # uppercase 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 e66a9af7f..7c47493e3 100644 --- a/styleguide/a-z-word-list-term-collections/u/upsize.md +++ b/styleguide/a-z-word-list-term-collections/u/upsize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # upsize 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 dfdeb8b36..9f8758bd0 100644 --- a/styleguide/a-z-word-list-term-collections/u/upward.md +++ b/styleguide/a-z-word-list-term-collections/u/upward.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # upward 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 90c11130b..d863c4dbc 100644 --- a/styleguide/a-z-word-list-term-collections/u/url.md +++ b/styleguide/a-z-word-list-term-collections/u/url.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # URL 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 cc1c34596..74567e117 100644 --- a/styleguide/a-z-word-list-term-collections/u/us.md +++ b/styleguide/a-z-word-list-term-collections/u/us.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # US 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 9e3dc2ff3..a29224bc3 100644 --- a/styleguide/a-z-word-list-term-collections/u/usable.md +++ b/styleguide/a-z-word-list-term-collections/u/usable.md @@ -1,10 +1,11 @@ --- title: usable - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # usable 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 56b3cd570..a1a3f8554 100644 --- a/styleguide/a-z-word-list-term-collections/u/usb.md +++ b/styleguide/a-z-word-list-term-collections/u/usb.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # USB 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 1634b3afc..5706605c4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # use terms 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 8837bdf15..2f909f806 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # user, end user 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 579d6430b..6c3cae03f 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # user rights 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 0af549533..740076807 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # using, by using, with 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 110a885ce..b454ab27c 100644 --- a/styleguide/a-z-word-list-term-collections/u/utility.md +++ b/styleguide/a-z-word-list-term-collections/u/utility.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # utility 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 5a4e02547..716008ab4 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # value axis 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 9bc97bed1..82589c18a 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # versus, vs. 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 51bd59a9c..4cae202ab 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # video call, videoconference 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 338509890..8b48539d6 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # video card 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 9b8672bbd..ca3c9f2f7 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # video display 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 2ac459539..bd22076b9 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # video driver 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 b5350b298..e784cfbae 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # video game, video-game 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 85e4b50b0..f59ead57d 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,10 +1,11 @@ --- title: virtual agent - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # virtual agent 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 01b634d08..8303b340b 100644 --- a/styleguide/a-z-word-list-term-collections/v/virtual.md +++ b/styleguide/a-z-word-list-term-collections/v/virtual.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # virtual 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 0fb72a007..3bb973933 100644 --- a/styleguide/a-z-word-list-term-collections/v/virtualize.md +++ b/styleguide/a-z-word-list-term-collections/v/virtualize.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # virtualize 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 2cae6b213..8b73cd904 100644 --- a/styleguide/a-z-word-list-term-collections/v/visit.md +++ b/styleguide/a-z-word-list-term-collections/v/visit.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # visit 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 4a30bbb0b..d3eecc9ff 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,10 +1,11 @@ --- title: voice-activated device - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # voice-activated device 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 d1e5fb8f5..a9adf4828 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,10 +1,11 @@ --- title: voice user interface (VUI) - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # voice user interface (VUI) 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 773912c2e..b8b1c2eb4 100644 --- a/styleguide/a-z-word-list-term-collections/v/voicemail.md +++ b/styleguide/a-z-word-list-term-collections/v/voicemail.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # voicemail 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 584b47cca..174f7b58b 100644 --- a/styleguide/a-z-word-list-term-collections/v/vulnerability.md +++ b/styleguide/a-z-word-list-term-collections/v/vulnerability.md @@ -1,10 +1,11 @@ --- title: vulnerability - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # vulnerability 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 087408e00..a46dce87a 100644 --- a/styleguide/a-z-word-list-term-collections/w/w3c.md +++ b/styleguide/a-z-word-list-term-collections/w/w3c.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # W3C 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 e17a25adb..58f0cbb18 100644 --- a/styleguide/a-z-word-list-term-collections/w/want.md +++ b/styleguide/a-z-word-list-term-collections/w/want.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # want 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 1928fc671..f4a7ac384 100644 --- a/styleguide/a-z-word-list-term-collections/w/we.md +++ b/styleguide/a-z-word-list-term-collections/w/we.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # we 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 886ebb09a..8baf7fe21 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # wearable, wearable device 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 96611f401..805174f07 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # web services 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 825218b29..73d412249 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # web, World Wide Web, WWW 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 000000000..d23941ee4 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/w/wellbeing.md @@ -0,0 +1,16 @@ +--- +title: wellbeing - Microsoft Style Guide +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.service: microsoft-writing-style-guide +--- + +# 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. 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 85dadcfe3..e1642c358 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,11 @@ --- title: where - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 56abedde7..171d5af0e 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,11 @@ --- title: while - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 e544f17f3..be2e0f528 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,11 @@ --- title: white hat hacker - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 41c285f1d..e4c9f5403 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,11 @@ --- title: white paper - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 f09b5f1e6..c3fd4acd5 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,11 @@ --- title: white space - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # white space 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 46c811939..c1ed4947d 100644 --- a/styleguide/a-z-word-list-term-collections/w/whitelist.md +++ b/styleguide/a-z-word-list-term-collections/w/whitelist.md @@ -1,16 +1,18 @@ --- 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: 01/19/2018 +ms.date: 1/15/2021 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # whitelist +Never use *whitelist*. Use *allowlist* instead. -Consider alternatives where possible. +For more specific usage, *safe senders list* can be used. **Examples** -Safe Recipients list -blocked or safe programs +You can use *safe senders lists* to help with false positives. +The *allowlist* is a list of digits that will not be blocked by the app. 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 110f017ea..99aed84b3 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 b6fef70fd..241fa8366 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 f22dd9590..327e260b9 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 007c22bdb..498bd8ab5 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # window diff --git a/styleguide/a-z-word-list-term-collections/w/windows-10-windows-11.md b/styleguide/a-z-word-list-term-collections/w/windows-10-windows-11.md new file mode 100644 index 000000000..de21b8c89 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/w/windows-10-windows-11.md @@ -0,0 +1,13 @@ +--- +title: Windows 10, Windows 11 - Microsoft Style Guide +description: Instructs to always use the entire name when referring to Windows 10 and Windows 11 and to not precede the name with Microsoft. +author: pallep +ms.author: pallep +ms.date: 11/15/2023 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# Windows 10, Windows 11 + +Always use the entire name. Don't precede the name with *Microsoft.* 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 deleted file mode 100644 index f483f84bb..000000000 --- a/styleguide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Windows 7, Windows 8, Windows 10 - Microsoft Style Guide -author: pallep -ms.author: pallep -ms.date: 01/19/2018 -ms.topic: article -ms.prod: non-product-specific ---- - -# Windows 7, Windows 8, Windows 10 - -Always use the entire name. Don't precede the name with *Microsoft.* 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 c127316a1..386fb0b82 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 8898df7a8..53b34b114 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 f9df43cd2..eebcdc24a 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,11 @@ --- title: wireframe - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 52ac41edf..2d01db16c 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 3c8684976..c4a1a8972 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,11 @@ --- title: wizard - Microsoft Style Guide +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 +ms.service: microsoft-writing-style-guide --- # 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 5db646fa8..ee6c9c3c4 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 aa1c13895..bfdf0b4cf 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 f03f30c8e..ecd866f4e 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 2fc6c4523..d67b4281b 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 7adf311fa..48262d1ce 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 424bdd468..ff261e55e 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 bb1f48937..8be6039d9 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,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # 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 new file mode 100644 index 000000000..698db4731 --- /dev/null +++ b/styleguide/a-z-word-list-term-collections/w/workstream.md @@ -0,0 +1,20 @@ +--- +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.service: microsoft-writing-style-guide +--- + +# 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. 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 261492fbb..06309c897 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,30 +1,24 @@ --- 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: 01/19/2018 +ms.date: 11/24/2020 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # worldwide vs. international -Use *worldwide* to describe something that encompasses all regions or involves the entire world. +Use *worldwide* to describe something that encompasses all regions or involves the entire world. It's OK to use *global* to mean *worldwide*. **Examples** Get one month of free, worldwide calling. OneNote Mobile for Android is now available in more than 20 markets worldwide. +Ensuring global acceptability in the usability of our products along with local relevance (world readiness). -Use *international* to describe something that: - - Involves two or more countries or regions. - - Crosses national boundaries. - -**Example** -International -Fonts and Text Display provides platform support for international -fonts and text to meet the typography needs of Windows customers -worldwide. +Don't use *international* in the context of something that encompasses the entire world as it can imply a US-centric worldview. Don’t use *international* to mean “outside the United States.” Instead, refer to a specific region or use wording that describes what you mean. 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 1e3e3d5c8..e1bcc5e42 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # write-only 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 eb0647c41..092c9ce45 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # write-protect, write-protected 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 41707ca58..cb047573c 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # x-axis 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 b9b7591ae..53ed46586 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # x-coordinate 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 a097cb435..2320d9b5a 100644 --- a/styleguide/a-z-word-list-term-collections/x/x.md +++ b/styleguide/a-z-word-list-term-collections/x/x.md @@ -1,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # x 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 8d1f2da3e..4be517e08 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # XON/XOFF 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 be5f6be04..c1ac8b269 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # y-axis 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 8339ed97c..959b9197b 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # y-coordinate 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 d0477be8a..7e6848319 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # z-axis 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 e1427facc..9e9adfa9b 100644 --- a/styleguide/a-z-word-list-term-collections/z/z.md +++ b/styleguide/a-z-word-list-term-collections/z/z.md @@ -1,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # z- 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 e4946ef1c..104c0c294 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # zero, zeros 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 552eb73b4..c37c1d7a3 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # ZIP Code 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 1444922bc..96f643348 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,10 +1,11 @@ --- 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 -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # zoom in, zoom out diff --git a/styleguide/accessibility/accessibility-guidelines-requirements.md b/styleguide/accessibility/accessibility-guidelines-requirements.md index f8a0dfe95..4423f8b19 100644 --- a/styleguide/accessibility/accessibility-guidelines-requirements.md +++ b/styleguide/accessibility/accessibility-guidelines-requirements.md @@ -1,16 +1,16 @@ --- -title: Accessibility guidelines and requirements - Microsoft Style Guide +title: Accessibility Guidelines and Requirements - Microsoft Style Guide +description: This section lists links to accessibility style guidelines for Microsoft devices and services. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 e783c2eb3..0e3b520a5 100644 --- a/styleguide/accessibility/colors-patterns-text-graphics-design.md +++ b/styleguide/accessibility/colors-patterns-text-graphics-design.md @@ -1,16 +1,16 @@ --- -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 provides Microsoft accessibility style guidelines on colors and patterns in text, graphics, and design. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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 5313f07c8..34e086540 100644 --- a/styleguide/accessibility/graphics-design-media.md +++ b/styleguide/accessibility/graphics-design-media.md @@ -1,21 +1,20 @@ --- -title: Graphics, design, and media - Microsoft Style Guide +title: Graphics, Design, and Media - Microsoft Style Guide +description: This article outlines Microsoft accessibility style guidelines for graphics, design, and media. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- -# 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 24100680a..62c77bfbc 100644 --- a/styleguide/accessibility/writing-all-abilities.md +++ b/styleguide/accessibility/writing-all-abilities.md @@ -1,24 +1,23 @@ --- -title: Writing for all abilities - Microsoft Style Guide +title: Writing for All Abilities - Microsoft Style Guide +description: This article outlines Microsoft style guidelines for writing in order to improve accessibility. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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 0043c8237..94cb5a8ef 100644 --- a/styleguide/acronyms.md +++ b/styleguide/acronyms.md @@ -1,37 +1,35 @@ --- 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: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Acronyms -Acronyms -and abbreviations can have an adverse effect on clarity, voice, and -SEO. Although some acronyms are widely understood and preferred to the +Acronyms and abbreviations can have an adverse effect on clarity, voice, and +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. ## 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 -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 -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. -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. @@ -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. @@ -76,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** diff --git a/styleguide/bias-free-communication.md b/styleguide/bias-free-communication.md index ad48f83c1..c91386073 100644 --- a/styleguide/bias-free-communication.md +++ b/styleguide/bias-free-communication.md @@ -1,10 +1,11 @@ --- 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: 09/13/2019 +ms.date: 04/18/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Bias-free communication @@ -79,17 +80,19 @@ countries with states or continents. **Don't use profane or derogatory terms,** such as *pimp* or *bitch.* -**Avoid culturally sensitive terms,** such as the terms associated with military or political actions or other historic events and eras. +**Don't use terms that may carry unconscious racial bias or terms associated with military actions, politics, or historical events and eras.** See [Militaristic language](https://learn.microsoft.com/en-us/style-guide/militaristic-language) for more information. | **Use this** | **Not this** | |--------------------|--------------------------| -| master/subordinate | master/slave | +| primary/subordinate | master/slave | | 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](~/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](~/accessibility/accessibility-guidelines-requirements.md), [Global communications](~/global-communications/index.md) +**See also** [Militaristic language](https://learn.microsoft.com/en-us/style-guide/militaristic-language), [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/) diff --git a/styleguide/brand-voice-above-all-simple-human.md b/styleguide/brand-voice-above-all-simple-human.md index eb7ef6527..e318cdf16 100644 --- a/styleguide/brand-voice-above-all-simple-human.md +++ b/styleguide/brand-voice-above-all-simple-human.md @@ -1,10 +1,11 @@ --- -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 ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Microsoft's brand voice: Above all, simple and human diff --git a/styleguide/breadcrumb/toc.yml b/styleguide/breadcrumb/toc.yml index 84f525fa0..ebd928b1b 100644 --- a/styleguide/breadcrumb/toc.yml +++ b/styleguide/breadcrumb/toc.yml @@ -1,3 +1,3 @@ -- name: Microsoft Style Guide +- name: Microsoft Writing Style Guide tocHref: /style-guide/ - topicHref: /style-guide/index \ No newline at end of file + topicHref: /style-guide/index diff --git a/styleguide/capitalization.md b/styleguide/capitalization.md index e3a9542c2..1e373b28b 100644 --- a/styleguide/capitalization.md +++ b/styleguide/capitalization.md @@ -1,10 +1,11 @@ --- 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: 09/6/2019 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Capitalization @@ -18,7 +19,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. @@ -42,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). @@ -104,7 +105,7 @@ On the rare occasions when title-style capitalization is required, follow these - Capitalize the word after a hyphen if it would be capitalized without the hyphen or it's the last word. **Examples** Self-Paced Training for Microsoft Visual Studio - Microsoft Management Console: Five Essential Snap-ins + Microsoft Management Console: Five Essential Snap-Ins Five Essential Snap-ins for Microsoft Management Console Copy-and-Paste Support in Windows Apps diff --git a/styleguide/chatbots-virtual-agents/care-feeding-bot.md b/styleguide/chatbots-virtual-agents/care-feeding-bot.md index 5ac2b8d0c..a40d13aa6 100644 --- a/styleguide/chatbots-virtual-agents/care-feeding-bot.md +++ b/styleguide/chatbots-virtual-agents/care-feeding-bot.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Care and feeding of the bot diff --git a/styleguide/chatbots-virtual-agents/index.md b/styleguide/chatbots-virtual-agents/index.md index 5b4646a58..22e19ba2e 100644 --- a/styleguide/chatbots-virtual-agents/index.md +++ b/styleguide/chatbots-virtual-agents/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Chatbots and virtual agents @@ -32,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/chatbots-virtual-agents/structural-technical-considerations.md b/styleguide/chatbots-virtual-agents/structural-technical-considerations.md index f4230f089..2ec0931b8 100644 --- a/styleguide/chatbots-virtual-agents/structural-technical-considerations.md +++ b/styleguide/chatbots-virtual-agents/structural-technical-considerations.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Structural and technical considerations diff --git a/styleguide/chatbots-virtual-agents/writing-bots.md b/styleguide/chatbots-virtual-agents/writing-bots.md index ef054c75c..96ea45814 100644 --- a/styleguide/chatbots-virtual-agents/writing-bots.md +++ b/styleguide/chatbots-virtual-agents/writing-bots.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Writing for bots diff --git a/styleguide/content-planning.md b/styleguide/content-planning.md index 0a428e5cc..4f6df8523 100644 --- a/styleguide/content-planning.md +++ b/styleguide/content-planning.md @@ -1,10 +1,11 @@ --- 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 +ms.date: 06/20/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Content planning @@ -89,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<br /> Documentation<br /> Short video<br /> 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)<br /> [Recall and replace sent messages](https://support.office.com/article/Recall-and-replace-sent-messages-ec29964f-ae72-4e32-bbab-945fe3dc3390)<br /> [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 <br /> Video <br /> Webcast <br /> Documentation <br /> Tutorial <br /> End-to-end scenarios or conceptual articles <br /> Technical papers or articles <br /> Wizard | [Try the latest touchpad gestures](https://windows.microsoft.com/windows-10/getstarted-try-touchpad-gestures) <br /> [OneNote for (holiday) planning](https://blogs.office.com/2013/11/08/webinar-onenote-for-holiday-planning/) <br /> [Create an ASP.NET web app in Azure App Service](https://azure.microsoft.com/documentation/articles/web-sites-dotnet-get-started/) <br /> [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) <br /> [Getting started with Microsoft Intune](https://www.bing.com/videos/search?q=getting+started+with+microsoft+intune&FORM=VIRE2#view=detail&mid=6C684C0693A2CB812D786C684C0693A2CB812D78) <br /> [Set up Microsoft account on your devices](https://account.microsoft.com/account/connect-devices?lang=en-us)<br /> | -| **Get timely communications, including news, announcements, event updates, tips, and stories** | Blog <br /> Newsletter | [OneNote, The Microsoft Office Blog](https://blogs.office.com/b/microsoft-onenote) <br /> [Virtual PC Guy’s blog](https://blogs.msdn.microsoft.com/virtual_pc_guy/) <br /> [MSDN Flash newsletter](https://msdn.microsoft.com/dn957574#full) | -| **Get answers and expertise from a community** | Wiki <br /> Forum | [TechNet wiki](https://social.technet.microsoft.com/wiki/) <br /> [Exchange Server Forum](https://social.technet.microsoft.com/Forums/category/exchangeserver) <br /> [Microsoft Answers](https://answers.microsoft.com/en-us) | +| **Complete a complex task or use a complex feature in an app** | UI text <br /> Video <br /> Webcast <br /> Documentation <br /> Tutorial <br /> End-to-end scenarios or conceptual articles <br /> Technical papers or articles <br /> Wizard | [Try the latest touchpad gestures](https://windows.microsoft.com/windows-10/getstarted-try-touchpad-gestures) <br /> [OneNote for (holiday) planning](https://blogs.office.com/2013/11/08/webinar-onenote-for-holiday-planning/) <br /> [Create an ASP.NET web app in Azure App Service](https://azure.microsoft.com/documentation/articles/web-sites-dotnet-get-started/) <br /> [Set up Office 365 for business](https://support.office.com/article/Set-up-Office-365-for-business-6a3a29a0-e616-4713-99d1-15eda62d04fa) <br /> [Getting started with Microsoft Intune](https://www.bing.com/videos/search?q=getting+started+with+microsoft+intune&FORM=VIRE2#view=detail&mid=6C684C0693A2CB812D786C684C0693A2CB812D78) <br /> [Set up Microsoft account on your devices](https://account.microsoft.com/account/connect-devices?lang=en-us)<br /> | +| **Get timely communications, including news, announcements, event updates, tips, and stories** | Blog <br /> Newsletter | [OneNote, The Microsoft Office Blog](https://blogs.office.com/b/microsoft-onenote) <br /> [Virtual PC Guy’s blog](https://blogs.msdn.microsoft.com/virtual_pc_guy/) <br /> | +| **Get answers and expertise from a community** | Wiki <br /> Forum | [TechNet wiki](https://social.technet.microsoft.com/wiki/) <br /> [Exchange Server Forum](https://social.technet.microsoft.com/Forums/category/exchangeserver) <br /> [Microsoft Answers](https://answers.microsoft.com/) | | **Learn a complex or comprehensive concept or skill** | Online training <br /> Tutorial <br /> Technical white paper <br /> Interactive graphics <br /> 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) <br /> [SharePoint Automation with DSC](https://mva.microsoft.com/training-courses/sharepoint-automation-with-dsc-17843) <br /> [Azure Network Security (PDF)](https://download.microsoft.com/download/C/A/3/CA3FC5C0-ECE0-4F87-BF4B-D74064A00846/AzureNetworkSecurity_v3_Feb2015.pdf) <br /> [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 <br /> E-books <br /> Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) <br /> [SharePoint with SQL Server AlwaysOn](https://azure.microsoft.com/documentation/infographics/sharepoint-sqlserver-alwayson/) <br /> [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 <br /> E-books <br /> Infographics | [Azure Security, Privacy, and Compliance (PDF)](https://download.microsoft.com/download/1/6/0/160216AA-8445-480B-B60F-5C8EC8067FCA/WindowsAzure-SecurityPrivacyCompliance.pdf) <br /> [SharePoint with SQL Server AlwaysOn](/SharePoint/administration/deploying-sharepoint-server-with-sql-server-alwayson-availability-groups-in) <br /> [Microsoft Dynamics NAV: Grow Your Business e-book](https://www.microsoft.com/download/details.aspx?id=44237) | | **Learn product tips and tricks** | UI text <br /> Web documentation <br /> Apps <br /> Microblogs (such as Twitter) <br /> Blogs <br /> E-books <br /> Newsletters <br /> 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/) <br /> [Skype: Keeping you connected on your vacation](https://blogs.windows.com/devices/2015/07/17/skype-keeping-you-connected-on-your-vacation/) <br /> [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 <br /> Interactive flow charts <br /> Sample workflows <br /> Sample files | [What is governance in SharePoint 2013?](https://technet.microsoft.com/library/cc263356.aspx) <br /> [Overview of the upgrade process for SharePoint 2013](https://technet.microsoft.com/library/cc262483.aspx) <br /> [Upgrade worksheet for SharePoint 2013](https://www.microsoft.com/download/confirmation.aspx?id=30370) | | **Troubleshoot a problem** | Interactive flow chart <br /> 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) | diff --git a/styleguide/design-planning.md b/styleguide/design-planning.md index 4fbe1e486..5749b8042 100644 --- a/styleguide/design-planning.md +++ b/styleguide/design-planning.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Design planning diff --git a/styleguide/developer-content/code-examples.md b/styleguide/developer-content/code-examples.md index 5df8f168c..24693d3d8 100644 --- a/styleguide/developer-content/code-examples.md +++ b/styleguide/developer-content/code-examples.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Code examples diff --git a/styleguide/developer-content/formatting-developer-text-elements.md b/styleguide/developer-content/formatting-developer-text-elements.md index cc8a61c73..f6428d63f 100644 --- a/styleguide/developer-content/formatting-developer-text-elements.md +++ b/styleguide/developer-content/formatting-developer-text-elements.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Formatting developer text elements diff --git a/styleguide/developer-content/index.md b/styleguide/developer-content/index.md index 172e7f0c1..ac78c372a 100644 --- a/styleguide/developer-content/index.md +++ b/styleguide/developer-content/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Developer content diff --git a/styleguide/developer-content/reference-documentation.md b/styleguide/developer-content/reference-documentation.md index 3d87ec2e1..e3ac2ca4d 100644 --- a/styleguide/developer-content/reference-documentation.md +++ b/styleguide/developer-content/reference-documentation.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Reference documentation @@ -50,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. <br />**Example**<br />`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.<br />**Examples**<br />*Source*<br />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.*<br /><br />*Destination*<br />Optional. A **String** value that contains a URL specifying the location where *Source* will be moved.<br /><br />*UserName*<br />Optional. A **String** value that contains the user ID that, if needed, authorizes access to *Destination.*<br /><br />*Password*<br />Optional. A **String** that contains the password that, if needed, verifies *UserName.*<br /><br />*Options*<br />Optional. A **MoveRecordOptionsEnum** value whose default value is **adMoveUnspecified**. Specifies the behavior of this method.<br /><br />*Async*<br />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. <br />**Example**<br />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. <br />**Example**<br />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.<br /><br />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.<br /><br />**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.<br /><br />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.<br /><br />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.<br /><br />**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. <br />**Example**<br />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.<br /><br />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.<br /><br />**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.<br /><br />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.<br /><br />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.<br /><br />**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.<br />**Example**<br />Record Object (ADO) | | **See also** | References or links to more information about how to use the element. References or links to related elements.<br />**Examples**<br />Move Method (ADO)<br />MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (ADO) <br />MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (RDS) | @@ -71,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). diff --git a/styleguide/docfx.json b/styleguide/docfx.json index 71ccf73af..60e46c0fb 100644 --- a/styleguide/docfx.json +++ b/styleguide/docfx.json @@ -32,13 +32,14 @@ "overwrite": [], "externalReference": [], "globalMetadata": { + "uhfHeaderId": "MSDocsHeader-StyleGuide", "breadcrumb_path": "/style-guide/breadcrumb/toc.json", "searchScope": [ "Style guide" ], "feedback_system": "GitHub", "feedback_github_repo": "MicrosoftDocs/microsoft-style-guide", - "extendBreadcrumb": true + "no_index_ks": true }, "fileMetadata": {}, "template": [], diff --git a/styleguide/final-publishing-review.md b/styleguide/final-publishing-review.md index ff1ee1a5f..485ccd999 100644 --- a/styleguide/final-publishing-review.md +++ b/styleguide/final-publishing-review.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Final publishing review diff --git a/styleguide/global-communications/art.md b/styleguide/global-communications/art.md index 3487e7483..5d1c9632b 100644 --- a/styleguide/global-communications/art.md +++ b/styleguide/global-communications/art.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Art diff --git a/styleguide/global-communications/currency.md b/styleguide/global-communications/currency.md index b955f1e28..476485581 100644 --- a/styleguide/global-communications/currency.md +++ b/styleguide/global-communications/currency.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Currency @@ -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.<br /> **Examples**<br />US dollar<br />Canadian dollar<br />Hong Kong SAR dollar<br />Brazilian real<br />South African rand<br />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.<br /> **Example** -![](media/currency/1453401234.png) +![Screenshot of a structured list showing countries and their respective currencies.](media/currency/1453401234.png) ## Specific monetary amounts diff --git a/styleguide/global-communications/examples-scenarios.md b/styleguide/global-communications/examples-scenarios.md index 96db88d22..e912127a8 100644 --- a/styleguide/global-communications/examples-scenarios.md +++ b/styleguide/global-communications/examples-scenarios.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Examples and scenarios diff --git a/styleguide/global-communications/index.md b/styleguide/global-communications/index.md index deeae896b..373f43f96 100644 --- a/styleguide/global-communications/index.md +++ b/styleguide/global-communications/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Global communications diff --git a/styleguide/global-communications/names-contact-information.md b/styleguide/global-communications/names-contact-information.md index 1a7e2d9dd..f9e1d7920 100644 --- a/styleguide/global-communications/names-contact-information.md +++ b/styleguide/global-communications/names-contact-information.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Names and contact information diff --git a/styleguide/global-communications/time-place.md b/styleguide/global-communications/time-place.md index b30041259..724ce4622 100644 --- a/styleguide/global-communications/time-place.md +++ b/styleguide/global-communications/time-place.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Time and place diff --git a/styleguide/global-communications/web-software-html-considerations.md b/styleguide/global-communications/web-software-html-considerations.md index 95658a55e..66f1f4a47 100644 --- a/styleguide/global-communications/web-software-html-considerations.md +++ b/styleguide/global-communications/web-software-html-considerations.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Web, software, and HTML considerations diff --git a/styleguide/global-communications/writing-tips.md b/styleguide/global-communications/writing-tips.md index c8c91b022..2335ffd83 100644 --- a/styleguide/global-communications/writing-tips.md +++ b/styleguide/global-communications/writing-tips.md @@ -1,10 +1,11 @@ --- 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: 04/30/2018 +ms.date: 06/14/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Writing tips @@ -31,7 +32,7 @@ it into multiple sentences. **Include *that* and *who*.** They help to clarify the sentence structure.<br /> **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.<br /> **Examples** @@ -95,4 +96,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. diff --git a/styleguide/grammar/dangling-misplaced-modifiers.md b/styleguide/grammar/dangling-misplaced-modifiers.md index 325903700..244c022a1 100644 --- a/styleguide/grammar/dangling-misplaced-modifiers.md +++ b/styleguide/grammar/dangling-misplaced-modifiers.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Dangling and misplaced modifiers diff --git a/styleguide/grammar/grammar-and-parts-of-speech.md b/styleguide/grammar/grammar-and-parts-of-speech.md index 278aeefe1..150ab9428 100644 --- a/styleguide/grammar/grammar-and-parts-of-speech.md +++ b/styleguide/grammar/grammar-and-parts-of-speech.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Grammar and parts of speech diff --git a/styleguide/grammar/ing-words.md b/styleguide/grammar/ing-words.md index 048272c18..491120916 100644 --- a/styleguide/grammar/ing-words.md +++ b/styleguide/grammar/ing-words.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Words ending in -ing diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md index 9f2c47935..3819b0e48 100644 --- a/styleguide/grammar/nouns-pronouns.md +++ b/styleguide/grammar/nouns-pronouns.md @@ -1,10 +1,11 @@ --- 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: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Nouns and pronouns @@ -27,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 @@ -42,11 +43,11 @@ Capitalize technology terms as proper nouns only when: from a general technology with a similar name, such as an SQL database server. - - The terms are typically capitalized in the industry. Search *[The American Heritage Dictionary](https://ahdictionary.com/),* reputable internet sites, and industry-specific dictionaries. Don't rely on unedited websites. + - The terms are typically capitalized in the industry. Search *[Merriam-Webster Dictionary](https://merriam-webster.com/),* reputable internet sites, and industry-specific dictionaries. Don't rely on unedited websites. -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. +If you're not sure whether a term is a proper noun (and thus capitalized) or a common noun (lowercase), check *[Merriam-Webster Dictionary](https://merriam-webster.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](/style-guide/grammar/person). ## Plural nouns @@ -54,7 +55,7 @@ Some nouns can be challenging to use in the plural. The simple rules that follow To check the spelling of plural forms of words derived from Latin and -Greek that retain their Latin or Greek endings (typically *-a, -us, -um, -on, -ix,* or -*ex*), see specific entries in the A–Z word list and *[The American Heritage Dictionary](https://ahdictionary.com/).* +Greek that retain their Latin or Greek endings (typically *-a, -us, -um, -on, -ix,* or -*ex*), see specific entries in the A–Z word list and *[Merriam-Webster Dictionary](https://merriam-webster.com/).* | **Noun** | **Plural form** | **Examples** | @@ -70,13 +71,12 @@ 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*). - -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](/style-guide/bias-free-communication). ## Pronouns and collective nouns @@ -84,3 +84,7 @@ Collective nouns like *company* take a singular pronoun. Don't use a plural pron **Examples**<br />Meet with up to 250 people. All they need is a phone or internet connection.<br />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](/style-guide/grammar/person). diff --git a/styleguide/grammar/person.md b/styleguide/grammar/person.md index 0336df0c9..5abed1042 100644 --- a/styleguide/grammar/person.md +++ b/styleguide/grammar/person.md @@ -1,39 +1,66 @@ --- 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: 09/13/2019 +ms.date: 06/24/2022 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Person 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.<br /> +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).<br /> + +**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.<br /> + **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 + +Remember my password -## Use first person sparingly +I agree to the terms of service -Use first person (usually *I* or *me*) only when you need to write from the point of view of the customer.<br /> -**Example** -Alert me when a new Bluetooth device tries to connect to my computer. (check box text) +**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. +![image](https://user-images.githubusercontent.com/88392507/175656804-d8ed81a0-12f3-45a7-9aa8-29278d3a3b98.png) **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. +It’s OK to use we in privacy and security settings where you need to make clear Microsoft is the speaker. <br /> -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.<br /> **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.*) -**See also** [Microsoft](~/a-z-word-list-term-collections/m/microsoft.md) +Allow Microsoft to contact you about this feedback diff --git a/styleguide/grammar/prepositions.md b/styleguide/grammar/prepositions.md index 283c890bc..c0e13ba3f 100644 --- a/styleguide/grammar/prepositions.md +++ b/styleguide/grammar/prepositions.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Prepositions diff --git a/styleguide/grammar/verbs.md b/styleguide/grammar/verbs.md index 7ccbde3e2..298658a29 100644 --- a/styleguide/grammar/verbs.md +++ b/styleguide/grammar/verbs.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Verbs diff --git a/styleguide/militaristic-language.md b/styleguide/militaristic-language.md new file mode 100644 index 000000000..32f98eae6 --- /dev/null +++ b/styleguide/militaristic-language.md @@ -0,0 +1,82 @@ +--- +title: Militaristic language - Microsoft Style Guide +description: Provides guidelines to avoid overly violent or militaristic language in everyday communications. +author: pallep +ms.author: pallep +ms.date: 04/17/2024 +ms.topic: article +ms.service: microsoft-writing-style-guide +--- + +# Militaristic language + +Avoid using terms associated with violence and military actions unless you are referring to physical combat operations. + +In the context of cybersecurity at Microsoft, use the following recommendations in the table of militaristic terms. + + +| **Use this** | **Not this** | +|----------------------------------------------|-------------------------------------------| +| address; protect against; respond to | combat; fight; eliminate | +| cyberattack chain | (cyber) kill chain | +| cyberattacker; bad actor; threat actor | attacker; adversary | +| impact | blast radius | +| multilayered approach; defense-in-depth cybersecurity | defense-in-depth approach | +| protect; safeguard; defend | guard; ward | +| secured | locked down | +| security; protection; defense | fortifications; first line of defense; frontlines | +| security teams; security analysts; defenders | frontline analysts | +| vulnerabilities; points of access; external exposure | external attack surface | + + +**Attack** +It’s ok to use *attack* if there’s context in front of it describing what kind of attack it is. For example, say, *Early detection is critical to preventing damage from malware attacks* instead of *Get protection from sophisticated attacks*. + +If there’s no context before attack that describes what kind of attack it is, add *cyber*- in front of threat so it reads *cyberattack*, all one word, no space, no hyphen. + +**Example** +Uncover and defend against advanced cyberattacks across your entire digital estate. + +**Defend, defense, and defenses** +It’s ok to use *defend* and *defenses* if there’s context in the same sentence that makes it clear they’re referring to cybersecurity. + +**Examples** +Learn how to defend your cloud and on-premises workloads. +Extend your defenses across endpoints and clouds with Microsoft Security. + +**External attack surface** +It’s ok to use this phrase when discussing external attack surface management, external attack surface management capabilities, or the product Microsoft Defender External Attack Surface Management. + +Don’t use the phrase *external attack surface* when referring to a customer’s points of access that are potentially vulnerable to an attack. Use *vulnerabilities*, *points of access*, or *external exposure* instead. + +**Threat** +It’s ok to use *threat* if there’s context in front of it describing what kind of threat it is. + +**Example** +Explore an integrated identity threat and response solution. + +If there’s no context before *threat* that describes what kind of threat it is, add *cyber*- in front of threat so it reads *cyberthreat*, all one word no space no hyphen. + +**Example** +Identify and remediate cyberthreats in the cloud and on-premises. + +**Threat intelligence** +It’s ok to use *threat intelligence* if the surrounding context makes it clear it’s related to cybersecurity. Don’t shorten to *threat intel*. + +**Example** +Get actionable insights into new and emerging cyberthreats with dynamic threat intelligence. + +**Never use** +These terms are overtly militaristic and should never be used in the context of cybersecurity at Microsoft (though they may be used to refer to physical combat operations): + +air cover +bomb, email bomb, mail bomb, time bomb +enemy, enemies, enemy lines +go on the offensive +invade, invasion +missile, torpedo +nuke, go nuclear +strike +troops + +See also [Bias-free communication](https://learn.microsoft.com/en-us/style-guide/bias-free-communication) diff --git a/styleguide/numbers.md b/styleguide/numbers.md index 1186f1423..2f5334be4 100644 --- a/styleguide/numbers.md +++ b/styleguide/numbers.md @@ -1,10 +1,11 @@ --- 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: 09/18/2019 +ms.date: 05/13/2022 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Numbers @@ -53,7 +54,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 <br /> 4 × 4 tile <br /> 8.5" × 11" paper <br /> 1280 × 1024 | -| Time of day. Include _AM_ or _PM._<br /> **Exception** Don't use numerals for _12:00_. Use _noon_ or _midnight_ instead.<br /> 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<br /> 6:30 PM<br /> The meeting is at noon. <br /> The event starts at 5:00 PM Pacific Time. <br /> The date changes at midnight. | +| Time of day. Include _AM_ or _PM._<br /> **Exception** Don't use numerals for _12∶00_. Use _noon_ or _midnight_ instead.<br /> 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<br /> 6∶30 PM<br /> The meeting is at noon. <br /> The event starts at 5∶00 PM Pacific Time. <br /> 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.<br /> Only 1 percent of the test group was unable to complete the task.<br /> A large percentage of system resources should be available. | | Coordinates of tables or worksheets and numbered sections of documents. | row 3, column 4 <br /> Volume 2 <br /> Chapter 10 <br /> Part 5 <br /> step 1 | @@ -84,6 +85,14 @@ all other content, follow the guidelines below. Don't use ordinal numbers, such as *June* *first* or *October twenty-eighth,* for dates. Use a numeral instead: *June 1, October 28.* **Global tip** To avoid confusion, always spell out the name of the month. The positions of the month and day vary by country. For example, 6/12/2017 might be June 12, 2017 or December 6, 2017. + +## Phone numbers + +Use hyphens—not parentheses, periods, spaces, or anything else—to separate the parts of a phone number. + +Example 612-555-0175 + +**Global tip** For information about how to format phone numbers in a region outside the United States and Canada, refer to the localization style guide for that region. ## Negative numbers @@ -151,7 +160,7 @@ all other content, follow the guidelines below. **Exceptions** <br /> 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.*<br /> - 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*. diff --git a/styleguide/procedures-instructions/describing-alternative-input-methods.md b/styleguide/procedures-instructions/describing-alternative-input-methods.md index 088cd6aa1..05a6bd9c7 100644 --- a/styleguide/procedures-instructions/describing-alternative-input-methods.md +++ b/styleguide/procedures-instructions/describing-alternative-input-methods.md @@ -1,10 +1,11 @@ --- 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: 06/14/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Describing alternative input methods @@ -68,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: <br /> <ul><li>Click **Internet Explorer**.</li></ul> | Display the **Start** menu by pressing the Windows logo key: <br /><ul><li>Select **Internet Explorer** by using the arrow keys, and then press **Enter**.</li> | -| **2** | In Internet Explorer:<br /><ul><li>Click the **Tools** menu.</li><li>Click **Internet Options**.</li></ul> | In Internet Explorer:<br /><ul><li>Select the **Tools** menu by pressing **Alt+T**.</li><li>Select **Internet Options** by pressing **O**.</li></ul> | +| **Mouse actions** | **Keyboard actions** | +|---|---| +|On the **Start** menu: <br /><ul><li> Click **Internet Explorer**.</li></ul> | Display the **Start** menu by pressing the Windows logo key: <br /><ul><li>Select **Internet Explorer** by using the arrow keys, then press **Enter**.</li> | +|In Internet Explorer:<br />1. Click the **Tools** menu. <br />2. Click **Internet Options**.</li></ul> | In Internet Explorer:<br /> 1. Select the **Tools** menu by pressing **Alt+T**. <br />2. Select **Internet Options** by pressing **O**.</li></ul> | **Document the primary input method,** and provide the alternative instructions in parentheses or separate sentences after the main instructions. <br /> **Examples** @@ -85,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 exit 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 @@ -107,4 +108,4 @@ or - To remove the selection, click **Cut** on the Quick Access Toolbar. - To copy the selection, click **Copy** on the Quick Access Toolbar. -2\. Right-click where you want to insert the text, and then click **Paste** on the Quick Access Toolbar. +2\. Right-click where you want to insert the text, then click **Paste** on the Quick Access Toolbar. diff --git a/styleguide/procedures-instructions/describing-interactions-with-ui.md b/styleguide/procedures-instructions/describing-interactions-with-ui.md index 46dfc89b8..7dab45ce4 100644 --- a/styleguide/procedures-instructions/describing-interactions-with-ui.md +++ b/styleguide/procedures-instructions/describing-interactions-with-ui.md @@ -1,10 +1,11 @@ --- 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: 9/21/2019 +ms.date: 06/14/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Describing interactions with UI @@ -20,16 +21,16 @@ input method. Don't use input-specific verbs, such as *click* or *swipe*. Instea | **Verb** | **Use for** | **Examples** | |---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Open** | <ul><li>Apps and programs</li></ul> <ul><li>Blades</li></ul> <ul><li>File Explorer</li></ul> <ul><li>Files and folders</li></ul> <ul><li>Shortcut menus</li></ul> <ul><li>Use for websites and webpages only when necessary to match the UI. Otherwise, use <em>go to</em>.</li></ul> <ul><li>Don't use for commands and menus.</li></ul> | <ul><li>Open Photos.</li></ul> <ul><li>Open the Reader app.</li></ul> <ul><li>Select <strong>Users + groups</strong> to open the blade.</li></ul> <ul><li>Open the Filename file.</li></ul> <ul><li>To open the document in Outline view, select <strong>View > Outline</strong>.</li></ul> <ul><li>In WindowName, open the shortcut menu for ItemName.</li></ul> | -| **Close** | <ul><li>Apps and programs</li></ul> <ul><li>Blades</li></ul> <ul><li>Dialog boxes</li></ul> <ul><li>Files and folders</li></ul> <ul><li>Notifications and alerts</li></ul> <ul><li>Tabs</li></ul> <ul><li>The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with <em>stop responding</em>.)</li></ul> | <ul><li>Close the Alarms app.</li></ul> <ul><li>Close Excel.</li></ul> <ul><li>Close the blade.</li></ul> <ul><li>Close the <strong>Users + groups</strong> blade.</li></ul> <ul><li>Save and close the document.</li></ul> <ul><li>Closing Excel also closes all open worksheets.</li></ul> | +| **Close** | <ul><li>Apps and programs</li></ul> <ul><li>Blades</li></ul> <ul><li>Dialogs</li></ul> <ul><li>Files and folders</li></ul> <ul><li>Notifications and alerts</li></ul> <ul><li>Tabs</li></ul> <ul><li>The action a program or app takes when it encounters a problem and can't continue. (Don't confuse with <em>stop responding</em>.)</li></ul> | <ul><li>Close the Alarms app.</li></ul> <ul><li>Close Excel.</li></ul> <ul><li>Close the blade.</li></ul> <ul><li>Close the <strong>Users + groups</strong> blade.</li></ul> <ul><li>Save and close the document.</li></ul> <ul><li>Closing Excel also closes all open worksheets.</li></ul> | | **Leave** | Websites and webpages | Select **Submit** to complete the survey and leave this page. | -| **Go to** | <ul><li>Opening a menu.</li></ul> <ul><li>Going to a tab or another particular place in the UI.</li></ul> <ul><li>Going to a website or webpage.</li></ul> <ul><li>It's OK to use <em>On the</em> <strong><em>XXX</em></strong> <em>tab</em> if the instruction is brief and continues immediately.</li></ul> | <ul><li>Go to Search <img src="media/describing-interactions-with-ui/721771267.png" /> , enter the word <strong>settings</strong>, and then select <strong>Settings</strong>. </li></ul> <ul><li>Go to <strong>File</strong>, and then select <strong>Close</strong>.</li></ul> <ul><li>On the ribbon, go to the <strong>Design</strong> tab. </li></ul> <ul><li>Go to the <strong>Deploy</strong> tab. In the <strong>Configuration</strong> list … </li></ul> <ul><li>On the <strong>Deploy</strong> tab, in the <strong>Configuration</strong> list … </li></ul> <ul><li>Go to Example.com to register.</li></ul> | -| **Select** | Instructing the customer to select a specific item, including:<br /><ul><li>Selecting an option, such as a button.</li></ul> <ul><li>Selecting a check box.</li></ul> <ul><li>Selecting a value from a list box.</li></ul> <ul><li>Selecting link text to go to a link.</li></ul> <ul><li>Selecting an item on a menu or shortcut menu.</li></ul> <ul><li>Selecting an item from a gallery.</li></ul> <ul><li>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.)</li></ul> | <ul><li>Select the <strong>Modify</strong> button.</li></ul> <ul><li>For <strong>Alignment</strong>, select <strong>Left</strong>. </li></ul> <ul><li>Select the text, open the shortcut menu, and then select <strong>Font</strong>.</li></ul> <ul><li>Select <strong>Open in new tab</strong>.</li></ul> <ul><li>Select the <strong>LinkName</strong> link.</li></ul> <ul><li>Select **F5**.</li></ul> <ul><li>Select **Shift+Enter**.</li></ul> <ul><li>Select **Ctrl+Alt+Delete**.</li></ul> | -| **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. | <ul><li>To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.</li></ul> <ul><li>Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.</li></ul> <ul><li>Select and hold (or right-click) the **Start** <img src="media/describing-interactions-with-ui/967781121.png" /> button, and then select **Device Manager**.</li></ul> | -| **>** | Use a greater-than symbol (>) to separate sequential steps.<br /><br />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.<br /><br />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. | +| **Go to** | <ul><li>Opening a menu.</li></ul> <ul><li>Going to a tab or another particular place in the UI.</li></ul> <ul><li>Going to a website or webpage.</li></ul> <ul><li>It's OK to use <em>On the</em> <strong><em>XXX</em></strong> <em>tab</em> if the instruction is brief and continues immediately.</li></ul> | <ul><li>Go to Search :::image type="icon" source="media/describing-interactions-with-ui/721771267.png":::, enter the word <strong>settings</strong>, and then select <strong>Settings</strong>. </li></ul> <ul><li>Go to <strong>File</strong>, and then select <strong>Close</strong>.</li></ul> <ul><li>On the ribbon, go to the <strong>Design</strong> tab. </li></ul> <ul><li>Go to the <strong>Deploy</strong> tab. In the <strong>Configuration</strong> list … </li></ul> <ul><li>On the <strong>Deploy</strong> tab, in the <strong>Configuration</strong> list … </li></ul> <ul><li>Go to Example.com to register.</li></ul> | +| **Select** | Instructing the customer to select a specific item, including:<br /><ul><li>Selecting an option, such as a button.</li></ul> <ul><li>Selecting a checkbox.</li></ul> <ul><li>Selecting a value from a list box.</li></ul> <ul><li>Selecting link text to go to a link.</li></ul> <ul><li>Selecting an item on a menu or shortcut menu.</li></ul> <ul><li>Selecting an item from a gallery.</li></ul> <ul><li>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.)</li></ul> | <ul><li>Select the <strong>Modify</strong> button.</li></ul> <ul><li>For <strong>Alignment</strong>, select <strong>Left</strong>. </li></ul> <ul><li>Select the text, open the shortcut menu, and then select <strong>Font</strong>.</li></ul> <ul><li>Select <strong>Open in new tab</strong>.</li></ul> <ul><li>Select the <strong>LinkName</strong> link.</li></ul> <ul><li>Select **F5**.</li></ul> <ul><li>Select **Shift+Enter**.</li></ul> <ul><li>Select **Ctrl+Alt+Delete**.</li></ul> | +| **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. | <ul><li>To flag a message that you want to deal with later, select and hold it, and then select **Set flag**.</li></ul> <ul><li>Select and hold (or right-click) the Windows taskbar, and then select **Cascade windows**.</li></ul> <ul><li>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**.</li></ul> | +| **>** | Use a greater-than symbol (>) to separate sequential steps.<br /><br />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.<br /><br />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. | <ul><li>Use the **Caps lock** key to switch from typing capital letters to typing lowercase letters. </li></ul> <ul><li>To switch between Normal, Outline, and Slide Sorter views, use the buttons on the <strong>View</strong> tab. </li></ul> <ul><li>To make text and apps easier to see, turn on the toggle under <strong>Turn on high contrast</strong>. </li></ul> <ul><li>To keep all applied filters, turn on the <strong>Pass all filters</strong> toggle.</li></ul> | | **Enter** | Instructing the customer to type or otherwise insert a value, or to type or select a value in a combo box. | <ul><li>In the search box, enter…</li></ul> <ul><li>In the **Tab stop position** box, enter the location where you want to set the new tab.</li></ul> <ul><li>In the **Deployment script name** box, enter a name for this script.</li></ul> | -| **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).<br /><br />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. | <ul><li>Drag the Filename file to the Foldername folder. </li></ul> <ul><li>Move the tile to the new section. </li></ul> <ul><li>Drag the Snipping Tool out of the way, if necessary, and then select the area you want to capture. </li></ul> <ul><li>If the <strong>Apply Styles</strong> task pane is in your way, just move it.</li></ul> | +| **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).<br /><br />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. | <ul><li>Drag the Filename file to the Foldername folder. </li></ul> <ul><li>Move the tile to the new section. </li></ul> <ul><li>Drag the Snipping Tool out of the way, if necessary, and then select the area you want to capture. </li></ul> <ul><li>If the <strong>Apply Styles</strong> task pane is in your way, just move it.</li></ul> | | **Zoom, zoom in, zoom out** | Use *zoom,* *zoom in,* and *zoom out* to refer to changing the magnification of the screen or window. | <ul><li>Zoom in to see more details on the map.</li></ul> <ul><li>Zoom out to see a larger geographic area on the map.</li></ul> <ul><li>Zoom in or out to see more or less detail.</li></ul> | diff --git a/styleguide/procedures-instructions/formatting-text-in-instructions.md b/styleguide/procedures-instructions/formatting-text-in-instructions.md index c87d78f9b..6f5d206b4 100644 --- a/styleguide/procedures-instructions/formatting-text-in-instructions.md +++ b/styleguide/procedures-instructions/formatting-text-in-instructions.md @@ -1,10 +1,11 @@ --- 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: 9/5/2019 +ms.date: 01/04/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Formatting text in instructions @@ -28,14 +29,14 @@ Use these conventions in instructions that appear in documentation and technical | **Element** | **Convention** | **Example** | |------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Blades** | Avoid talking about blades. Instead, describe what the customer needs to do. <br /> When you must refer to a blade by name, use bold formatting for the name of the blade. <br /> Use sentence-style capitalization unless you need to match the UI. <br /> Don't include the word *blade* unless it adds needed clarity. | Select a specific operation to view details about that operation.<br /> In **Web app**, provide a name for your site.<br /> Go to **Audit logs** to view the events that occurred against the subscription.<br /> On the **Resource group** blade, select **Summary**. | -| **Buttons, check boxes, and other options** | Avoid talking about UI elements. Instead, describe what the customer needs to do. <br /> When you must refer to a button, check box, or other option, use bold formatting for the name. <br /> Use sentence-style capitalization unless you need to match the UI. If an option label ends with a colon or an ellipsis, don't include that end punctuation in instructions. <br /> Don't include the type of UI element, such as *button* or *check box,* unless including it adds needed clarity. | Select **Save as** (*not* Select **Save as…** or Select the **Save as** button). <br /> Select **Allow row to break across pages**. <br /> Clear the **Match case** check box. | +| **Buttons, checkboxes, and other options** | Avoid talking about UI elements. Instead, describe what the customer needs to do. <br /> When you must refer to a button, checkbox, or other option, use bold formatting for the name. <br /> Use sentence-style capitalization unless you need to match the UI. If an option label ends with a colon or an ellipsis, don't include that end punctuation in instructions. <br /> Don't include the type of UI element, such as *button* or *checkbox,* unless including it adds needed clarity. | Select **Save as** (*not* Select **Save as…** or Select the **Save as** button). <br /> Select **Allow row to break across pages**. <br /> Clear the **Match case** checkbox. | | **Command-line commands** | Bold. All lowercase. | **copy** | | **Command-line options (also known as switches or flags)** | Bold. Capitalize the way the option must be typed. | **/a**<br />**/Aw** | | **Commands** | Use bold formatting for command names.<br />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.<br />Don't include the word *command* unless it adds needed clarity. | Go to **Tools**, and select **Change language**.<br /> 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.<br />When you must refer to a dialog box by name, use bold formatting for the name of the dialog box. <br /> 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. <br />Don't include the words *dialog box* unless it adds needed clarity. | Select **Upload**, and then select a file to upload.<br /> In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**.<br /> In the **Protect document** dialog box, clear the **Shapes** check box. | -| **Error messages** | Sentence-style capitalization. Enclose error messages in quotation marks when referring to them in text. | We can't find a scanner.<br />Hmm ... looks like that's a broken link.<br /> If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device.<br /> | +| **Dialog boxes** | In general, avoid talking about UI. Instead, talk about what the customer needs to do. <br />When you need to refer to the UI element, use *dialog*. Don't use *pop-up window*, *dialog box*, or *dialogue box*.<br />When you must refer to a dialog by name, use bold formatting for its name. <br /> 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. <br /> | Select **Upload**, and then select a file to upload.<br /> In **Properties**, select **Details**, and then select **Remove Properties and Personal Information**.<br /> 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. | Hmm ... looks like that's a broken link.<br /> If you see the error message, "Check scanner status and try again," use Windows Update to check for the latest drivers for your device.<br /> | | **File attributes** | All lowercase. | To remove the hidden attribute from all files in a folder .... | | **File name extensions** | All lowercase. | .mdb <br /> .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 <br /> MyTaxesFor2016 <br /> Enter **MyTaxesFor2016**. | 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 9af533a2f..000000000 --- a/styleguide/procedures-instructions/illustrating-network-traffic-flows.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Illustrating network traffic flows - Microsoft Style Guide -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. - -![](media/illustrating-network-traffic-flows/589503366.PNG)<br /><br /> - -**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. - -![](media/illustrating-network-traffic-flows/1252879060.png)<br /><br /> - -**Label specific network traffic.** If possible, overlay the label onto the line: - -![](media/illustrating-network-traffic-flows/83067036.png)<br /><br /> - -Otherwise, add the label as a callout: - -![](media/illustrating-network-traffic-flows/572369390.png) - -## 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. - -![](media/illustrating-network-traffic-flows/881348326.png) - -## 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 | - diff --git a/styleguide/procedures-instructions/index.md b/styleguide/procedures-instructions/index.md index 72c8e5101..ea499e150 100644 --- a/styleguide/procedures-instructions/index.md +++ b/styleguide/procedures-instructions/index.md @@ -1,36 +1,36 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # 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 - ![](media/index/1980906142.png) + ![A screenshot of two columns. The left, blue column reads In SharePoint Server 2013 on-premise. The right, red column reads in Office 365.](media/index/1980906142.png) - A video. - ![](media/index/774741777.png) + ![Screenshot of a paused video under a description of an article with a header reading Getting started with Internet Explorer 11.](media/index/774741777.png) - A one-sentence instruction. - ![](media/index/1713306812.png) + ![Screenshot of an article header reading Call a friend followed by a one-sentence instruction and various examples of the instruction.](media/index/1713306812.png) - A numbered procedure, which might include pictures, videos, and links or buttons that take customers where they need to go. - ![](media/index/541572162.png) + ![Screenshot of an article with the Adding your files to OneDrive header followed by four numbered steps, each with an accompanying image.](media/index/541572162.png) 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 d82402661..7cfbfc5f4 100644 --- a/styleguide/procedures-instructions/writing-step-by-step-instructions.md +++ b/styleguide/procedures-instructions/writing-step-by-step-instructions.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Writing step-by-step instructions @@ -63,11 +64,11 @@ 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. - ![](media/writing-step-by-step-instructions/1122697927.png) + ![Screenshot of the Visual Studio Online screen's Sprint 1 option being highlighted and the Set Dates option opening the Edit Iteration pane.](media/writing-step-by-step-instructions/1122697927.png) ## Single-step procedures diff --git a/styleguide/punctuation/apostrophes.md b/styleguide/punctuation/apostrophes.md index 5de215dea..310bb2bbf 100644 --- a/styleguide/punctuation/apostrophes.md +++ b/styleguide/punctuation/apostrophes.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Apostrophes diff --git a/styleguide/punctuation/colons.md b/styleguide/punctuation/colons.md index c16a53c13..c7f2ac645 100644 --- a/styleguide/punctuation/colons.md +++ b/styleguide/punctuation/colons.md @@ -1,10 +1,11 @@ --- 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: 07/24/2018 +ms.date: 11/01/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Colons @@ -13,7 +14,7 @@ ms.prod: non-product-specific Include a colon at the end of a phrase that directly introduces a list.<br /> **Example** -We can create a backup of all sorts of things to make the transition easier, including: +You can create a backup of all sorts of things to make the transition easier, including: - The apps you've installed on your phone, along with high scores and progress from participating apps. - The passwords for your accounts. @@ -46,3 +47,8 @@ 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 a colon when introducing lists of radio buttons or checkboxes. + diff --git a/styleguide/punctuation/commas.md b/styleguide/punctuation/commas.md index 68d57257c..93d0295da 100644 --- a/styleguide/punctuation/commas.md +++ b/styleguide/punctuation/commas.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Commas diff --git a/styleguide/punctuation/dashes-hyphens/emes.md b/styleguide/punctuation/dashes-hyphens/emes.md index d0a1d8f84..f24bf3c8a 100644 --- a/styleguide/punctuation/dashes-hyphens/emes.md +++ b/styleguide/punctuation/dashes-hyphens/emes.md @@ -1,10 +1,11 @@ --- 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 an em dash. author: pallep ms.author: pallep -ms.date: 01/19/2018 +ms.date: 05/09/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Em dashes @@ -18,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. diff --git a/styleguide/punctuation/dashes-hyphens/enes.md b/styleguide/punctuation/dashes-hyphens/enes.md index 7c26ea7d0..3fb7a9a22 100644 --- a/styleguide/punctuation/dashes-hyphens/enes.md +++ b/styleguide/punctuation/dashes-hyphens/enes.md @@ -1,15 +1,16 @@ --- 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 +ms.date: 11/06/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # En dashes -Use an en dash: +Use an en dash (–): - To indicate a range of numbers, such as inclusive values, dates, or pages. **Example** @@ -28,7 +29,7 @@ Use an en dash (–) instead of a hyphen in a compound modifier when: - One element of the modifier is an open compound. **Examples** Windows 10–compatible products -dialog box–type options +dialog–type options - Two or more of the elements are made up of hyphenated compounds (a rare occurrence). @@ -36,16 +37,11 @@ Don’t use an en dash to indicate an empty cell in a table. Don’t use spaces on either side of an en dash. -**Exception** Surround an en dash with spaces when it's used as a minus sign in an equation or in a time stamp appearing in UI. -**Examples** +**Exception** Surround an en dash with spaces when it's used as a minus sign in an equation, in a time stamp appearing in UI, or in a date range that includes two times and two dates. 12 – 3 = 9 -2:15 PM 12/1/16 ‒ 4:45 PM 4/1/16. +2:15 PM – 4:45 PM (time stamp in UI) +2:15 PM 12/1/17 – 4:45 PM 4/1/18 (range includes both time and date) In text, don’t use an en dash in a range of times. Use *to* instead: *10:00 AM to 2:00 PM.* In a schedule or listing, use an en dash with no spaces around it: *10:00 AM–2:00 PM*. -**Exception** In a date range that includes two times and two dates, add spaces around the en dash. -**Examples** -2:15 AM‒4:45 PM 4/1/16 (time range on a single day) -2:15 PM 12/1/17 ‒ 4:45 PM 4/1/18 (range includes both time and date) - **See also** [Date and time term collection](~/a-z-word-list-term-collections/term-collections/date-time-terms.md) diff --git a/styleguide/punctuation/dashes-hyphens/hyphens.md b/styleguide/punctuation/dashes-hyphens/hyphens.md index a51abc4a9..e11eaef4f 100644 --- a/styleguide/punctuation/dashes-hyphens/hyphens.md +++ b/styleguide/punctuation/dashes-hyphens/hyphens.md @@ -1,15 +1,16 @@ --- 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: 09/6/2019 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Hyphens -For information about hyphenating specific technology words, see the A–Z word list. For information about hyphenating common words, see [*The American Heritage Dictionary*](https://ahdictionary.com/) and [*The Chicago Manual of Style*](https://www.chicagomanualofstyle.org/home.html). +For information about hyphenating specific technology words, see the A–Z word list. For information about hyphenating common words, see *[Merriam-Webster Dictionary](https://merriam-webster.com/)* and [*The Chicago Manual of Style*](https://www.chicagomanualofstyle.org/home.html). ## Predicate adjectives @@ -27,7 +28,7 @@ In compound words that precede and modify a noun as a unit, don’t hyphenate: **Example** Very fast test - - An adverb ending in *-ly,* such as *completely,* when it precedes another modifier. Check [*The American Heritage Dictionary*](https://ahdictionary.com/) if you're not sure whether the word ending in *-ly* is an adverb.<br /> + - An adverb ending in *-ly,* such as *completely,* when it precedes another modifier. Check*[Merriam-Webster Dictionary](https://merriam-webster.com/)* if you're not sure whether the word ending in *-ly* is an adverb.<br /> **Examples** extremely stylized image highly graphical interface <br /><br /> @@ -102,15 +103,24 @@ 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. -| | | | | | -| ------ | ----- | ------ | ---- | ----- | -| 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: @@ -137,11 +147,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. | -**See also** [Capitalization](/styleguide/capitalization.md). +| 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](~/capitalization.md) diff --git a/styleguide/punctuation/dashes-hyphens/index.md b/styleguide/punctuation/dashes-hyphens/index.md index eec1e9dee..e3528a3c1 100644 --- a/styleguide/punctuation/dashes-hyphens/index.md +++ b/styleguide/punctuation/dashes-hyphens/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Dashes and hyphens diff --git a/styleguide/punctuation/ellipses.md b/styleguide/punctuation/ellipses.md index 504263c77..71136bb6b 100644 --- a/styleguide/punctuation/ellipses.md +++ b/styleguide/punctuation/ellipses.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Ellipses @@ -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. -![](media/ellipses/2036405554.png)![](media/ellipses/2085992510.png) +![Screenshot of a presentation slide with a line to a note above the slide reading When you apply a design template...](media/ellipses/2036405554.png)![Screenshot of a presentation slide with brackets to the right of the slide with text reading formatting and items change...](media/ellipses/2085992510.png) - Ensure that the path through the callouts is clear. Document each step. diff --git a/styleguide/punctuation/exclamation-points.md b/styleguide/punctuation/exclamation-points.md index 1b3bf8247..61c503781 100644 --- a/styleguide/punctuation/exclamation-points.md +++ b/styleguide/punctuation/exclamation-points.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Exclamation points diff --git a/styleguide/punctuation/formatting-punctuation.md b/styleguide/punctuation/formatting-punctuation.md index c224a8382..08f63d310 100644 --- a/styleguide/punctuation/formatting-punctuation.md +++ b/styleguide/punctuation/formatting-punctuation.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Formatting punctuation @@ -15,7 +16,7 @@ In general, format punctuation in the same font style as the main content of a s In instructions that reference elements such as commands, -options, keywords, placeholders, hyperlinks, pop-up text, and +options, keywords, placeholders, links, pop-up text, and user input: - If the punctuation diff --git a/styleguide/punctuation/index.md b/styleguide/punctuation/index.md index 0defe1560..7fbe1de10 100644 --- a/styleguide/punctuation/index.md +++ b/styleguide/punctuation/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Punctuation diff --git a/styleguide/punctuation/periods.md b/styleguide/punctuation/periods.md index 625563544..884089b6c 100644 --- a/styleguide/punctuation/periods.md +++ b/styleguide/punctuation/periods.md @@ -1,10 +1,11 @@ --- title: Periods - Microsoft Style Guide +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: 01/19/2018 +ms.date: 05/13/2022 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Periods @@ -15,6 +16,9 @@ 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](/style-guide/scannable-content/lists). + + **Headline example** Be brief—make every word count diff --git a/styleguide/punctuation/question-marks.md b/styleguide/punctuation/question-marks.md index cc6cbf83e..09e7f797e 100644 --- a/styleguide/punctuation/question-marks.md +++ b/styleguide/punctuation/question-marks.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Question marks diff --git a/styleguide/punctuation/quotation-marks.md b/styleguide/punctuation/quotation-marks.md index df6ef4502..faf06cfaf 100644 --- a/styleguide/punctuation/quotation-marks.md +++ b/styleguide/punctuation/quotation-marks.md @@ -1,36 +1,33 @@ --- title: Quotation marks - Microsoft Style Guide +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.prod: non-product-specific +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?" diff --git a/styleguide/punctuation/semicolons.md b/styleguide/punctuation/semicolons.md index b48df3e28..d732dc0f6 100644 --- a/styleguide/punctuation/semicolons.md +++ b/styleguide/punctuation/semicolons.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Semicolons diff --git a/styleguide/punctuation/slashes.md b/styleguide/punctuation/slashes.md index fcdff19c3..3b3484ffc 100644 --- a/styleguide/punctuation/slashes.md +++ b/styleguide/punctuation/slashes.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Slashes diff --git a/styleguide/responsive-content.md b/styleguide/responsive-content.md index e2c82cc23..7921b6f24 100644 --- a/styleguide/responsive-content.md +++ b/styleguide/responsive-content.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Responsive content diff --git a/styleguide/scannable-content/headings.md b/styleguide/scannable-content/headings.md index a23aeed1a..3f30d7947 100644 --- a/styleguide/scannable-content/headings.md +++ b/styleguide/scannable-content/headings.md @@ -1,10 +1,11 @@ --- title: Headings - Microsoft Style Guide +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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Headings @@ -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. - ![](media/headings/190123509.png) + ![Screenshot of the Style Name dropdown menu with the Subtle Emphasis option being highlighted.](media/headings/190123509.png) diff --git a/styleguide/scannable-content/index.md b/styleguide/scannable-content/index.md index e25099a3d..1f27dda22 100644 --- a/styleguide/scannable-content/index.md +++ b/styleguide/scannable-content/index.md @@ -1,10 +1,11 @@ --- 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 +ms.date: 06/20/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Scannable content @@ -61,8 +62,7 @@ readers with at least one way to navigate within it, so they can quickly get to what they need. - If - you're developing content for a collection, such as the MSDN or - TechNet libraries, break the content up into sections so + you're developing content for a collection, break the content up into sections so that information is easy to find in the library navigation. - In diff --git a/styleguide/scannable-content/lists.md b/styleguide/scannable-content/lists.md index fe47fe14a..ff9f38401 100644 --- a/styleguide/scannable-content/lists.md +++ b/styleguide/scannable-content/lists.md @@ -1,37 +1,40 @@ --- 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: 01/19/2018 +ms.date: 06/14/2023 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Lists Lists are a great way to present complex text in a way that's easy to scan. -Lists -work best when they have two to seven items. Each item should be fairly -short—the reader should be able to see at least two, and preferably -three, list items at a glance. It’s OK to have a couple of short -paragraphs in a list item, but don’t exceed that length too often. +A list should have at least two items but no more than seven items. Each item should be fairly short—the reader should be able to see at least two, and preferably three, list items at a glance. It’s OK to have a couple of short paragraphs in a list item, but don’t exceed that length too often. -Make items in a list parallel. For example, each item should be a noun or a phrase that starts with a verb. +Make all the items in a list consistent in structure. For example, each item should be a noun or a phrase that starts with a verb. ## Bulleted lists Use a bulleted list for things that have something in common but don’t need to appear in a particular order.<br /> -**Example**<br />The database owner can: +**Examples**<br />The database owner can: - Create and delete a database. - Add, delete, or modify a document. - Add, delete, or modify any information in the database. +<br />Bring your customers into focus + - Own your customer relationship. + - Create raving fans. + - Engage in new ways. + + ## Numbered lists Use a numbered list for sequential items (like a procedure) or prioritized items (like a top 10 list).<br /> -**Example**<br />**To sign on to a database** +**Example**<br />**To sign on to a database:** 1. On the **File** menu, select **Open database**. 2. In **Username**, enter your name. @@ -62,10 +65,42 @@ all items begin with lowercase words. ## Punctuation -In bulleted and numbered lists, end each list item with a period if: +Don’t use semicolons, commas, or conjunctions (like *and* or *or*) at the end of list items. + +Don’t use a period at the end of list items unless they’re complete sentences, even if the complete sentence is very short. + +**Examples**<br />Devices affected by this recall + + - Original Surface Pro + - Surface Pro 2 + - Surface Pro 3 + +<br />Limitations on meeting organizers + - Only invited presenters can be selected as breakout room managers. + - The number of breakout room managers is limited to 10. + - Breakout room managers can't be assigned to specific rooms, but they can move freely between rooms. + +If the list is introduced by a sentence fragment that ends with a colon, end all the items in the list with a period if any item forms a complete sentence when combined with the introduction. - - Any item forms a complete sentence when combined with the list introduction that precedes the colon. <br /> **Exception** Don’t use periods if all items have three or fewer words or if the items are UI labels, headings, subheadings, or strings. +**Examples**<br />Knowledge managers can: + + - Confirm or remove topics that were discovered in your tenant. + - Create new topics manually as needed. + - Edit existing topic pages. + +**Exception** Don’t use periods if all items have three or fewer words or if the items are UI labels, headings, subheadings, strings, or similar types of text. - - Any item *by itself* is a complete sentence. +<br />The administrative templates for Microsoft Edge are: -Don’t use semicolons, commas, or conjunctions (like *and* or *or*) at the end of list items. + - msedge.admx + - msedgeupdate.admx + +<br />The topic answer will display: + + - The topic name + - Alternate names + - The definition + +## 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. diff --git a/styleguide/scannable-content/pull-quotes.md b/styleguide/scannable-content/pull-quotes.md index 65effe800..6c8717708 100644 --- a/styleguide/scannable-content/pull-quotes.md +++ b/styleguide/scannable-content/pull-quotes.md @@ -1,17 +1,18 @@ --- 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. author: pallep ms.author: pallep ms.date: 01/19/2018 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Pull quotes 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. -![](media/pull-quotes/pull-quote.png) +![Screenshot of a pull quote reading If it's not fun, you're doing it wrong.](media/pull-quotes/pull-quote.png) 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 cb781cdb3..55f5a32c8 100644 --- a/styleguide/scannable-content/sidebars.md +++ b/styleguide/scannable-content/sidebars.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Sidebars @@ -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. -![](media/sidebars/1416770987.png) +![Screenshot of an article with a sidebar the provides statistics that accompany the written content.](media/sidebars/1416770987.png) diff --git a/styleguide/scannable-content/tables.md b/styleguide/scannable-content/tables.md index 5516fe2bd..6a8ae3a37 100644 --- a/styleguide/scannable-content/tables.md +++ b/styleguide/scannable-content/tables.md @@ -1,10 +1,11 @@ --- 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 +ms.service: microsoft-writing-style-guide --- # Tables @@ -53,12 +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 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. @@ -73,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). @@ -81,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 diff --git a/styleguide/search-writing.md b/styleguide/search-writing.md index b04ddf020..c9f26a5f3 100644 --- a/styleguide/search-writing.md +++ b/styleguide/search-writing.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Search and writing diff --git a/styleguide/text-formatting/formatting-common-text-elements.md b/styleguide/text-formatting/formatting-common-text-elements.md index e7b98202e..055ca86a3 100644 --- a/styleguide/text-formatting/formatting-common-text-elements.md +++ b/styleguide/text-formatting/formatting-common-text-elements.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Formatting common text elements diff --git a/styleguide/text-formatting/formatting-titles.md b/styleguide/text-formatting/formatting-titles.md index 1964abc5f..304b2cc0b 100644 --- a/styleguide/text-formatting/formatting-titles.md +++ b/styleguide/text-formatting/formatting-titles.md @@ -1,25 +1,38 @@ --- 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 +ms.date: 02/22/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Formatting titles -Follow these conventions for formatting titles. +In general, use sentence-style casing (that is, only capitalize the first word of a title, like at the beginning of a sentence), as this makes content more readable and ensures better localizability. -**See also** [Capitalization](~/capitalization.md), [Headings](~/scannable-content/headings.md) +Use bold font instead of italics for titles to enhance readability and accessibility. + +There are some notable exceptions to sentence-casing. These include: + ++ The titles of books (including e-books), white papers, and reports: + +**Unraveling HTML5, CSS3, and JavaScript** + +**Backup and Recovery Overview for Azure Customers** + ++ Games: + +Some of the top games on Microsoft Store include **Sea of Thieves 2023 Edition** and **Stardew Valley**. -| **Titles** | **Convention** | **Example** | -|---|---|--| -| **Games** | Title-style capitalization. Italic. | *Halo: Reach* | -| **Books** | Title-style capitalization. Italic in body text, citations, and other text references. | Check out _Unraveling HTML5, CSS3, and JavaScript_ (in body text) <br /> Minecraft: The Complete Handbook Collection (in a heading) | -| **Chapters and sections of books** | Usually sentence-style capitalization. Enclose in quotation marks. | See Chapter 9, "Extending forms." <br /> See “Managing your contacts” | -| **White papers** | Title-style capitalization. | Backup and Recovery Overview for Azure Customers <br /> Advanced Analytics with Power BI <br />The Evolution of Malware Prevention | -| **Song titles** | Title-style capitalization. In citations, enclose song titles in quotation marks and italicize album titles. | Run the World (Girls) <br /> Everything Is Awesome <br /> Shut Up and Dance | -| **Blog titles** | Title-style capitalization. In references, don't enclose the title in quotation marks. | Microsoft on the Issues <br /> The Official Microsoft Blog <br /> Welcome to This Week on Windows, where we bring you the latest in Windows news, apps, and tips from experts here at Microsoft. | -| **Titles of blog posts, web articles, and press releases** | Sentence-style capitalization. It's OK to use title-style capitalization to highlight a blog or article title in a tweet. If a reference to a blog post, article, or press release isn't linked, enclose the title in quotation marks. | Excel goes to camp <br /> Securing your preproduction environment in the cloud <br /> For information about the latest scam tactics, see "Tech support scams are a growing problem" on the Microsoft on the Issues blog. | ++ Events and webinars: + +The **Microsoft Envision AI Tour** is for decision-makers and developers, with events curated for each audience. + +**OneNote Best Practices for Educators and Students with Mike Tholfsen** + + + +**See also** [Capitalization](~/capitalization.md), [Headings](~/scannable-content/headings.md) diff --git a/styleguide/text-formatting/index.md b/styleguide/text-formatting/index.md index ac7366b31..6240e8f75 100644 --- a/styleguide/text-formatting/index.md +++ b/styleguide/text-formatting/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Text formatting 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 b73ff9af6..5245308ac 100644 --- a/styleguide/text-formatting/using-type/dont-compress-line-spacing.md +++ b/styleguide/text-formatting/using-type/dont-compress-line-spacing.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Don't compress line spacing diff --git a/styleguide/text-formatting/using-type/index.md b/styleguide/text-formatting/using-type/index.md index 59da4f1a3..dd336d27e 100644 --- a/styleguide/text-formatting/using-type/index.md +++ b/styleguide/text-formatting/using-type/index.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Using type diff --git a/styleguide/text-formatting/using-type/use-left-alignment.md b/styleguide/text-formatting/using-type/use-left-alignment.md index 00460a0a5..132c4ed22 100644 --- a/styleguide/text-formatting/using-type/use-left-alignment.md +++ b/styleguide/text-formatting/using-type/use-left-alignment.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use left alignment 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 ce61d8187..c29c3f40f 100644 --- a/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md +++ b/styleguide/text-formatting/using-type/use-sentence-style-capitalization.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use sentence-style capitalization diff --git a/styleguide/top-10-tips-style-voice.md b/styleguide/top-10-tips-style-voice.md index 12ced04d2..29dbbe7ae 100644 --- a/styleguide/top-10-tips-style-voice.md +++ b/styleguide/top-10-tips-style-voice.md @@ -1,10 +1,11 @@ --- 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: 09/05/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Top 10 tips for Microsoft style and voice @@ -59,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 @@ -71,7 +72,7 @@ Capitalization (Like This). Never Ever. To learn more, see [Capitalization](~/ca With these:<br />Find a Microsoft partner<br />Office 365 customer<br />Limited-time offer<br />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). diff --git a/styleguide/urls-web-addresses.md b/styleguide/urls-web-addresses.md index ef837aad7..4db31cbd1 100644 --- a/styleguide/urls-web-addresses.md +++ b/styleguide/urls-web-addresses.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # URLs and web addresses @@ -37,7 +38,7 @@ To refer to an entire website or top-level domain, such as Microsoft.com, omit * **Examples** www<span></span>.microsoft.com Microsoft.com -Codeplex.com is home to the open source project site hosted by Microsoft. +Codeplex.com is home to the open-source project site hosted by Microsoft. ## Grammar and formatting diff --git a/styleguide/welcome/index.md b/styleguide/welcome/index.md index 25b59c844..6c1e41090 100644 --- a/styleguide/welcome/index.md +++ b/styleguide/welcome/index.md @@ -1,16 +1,16 @@ --- -title: Welcome - Microsoft Style Guide +title: Welcome - Microsoft Writing 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: 04/3/2019 +ms.date: 05/10/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Welcome -![](media/index/WritingStyleGuidebanner.png) +![Header image reading Microsoft Style Guide on a background with a cup containing a pencil, pen, ruler, and paintbrush.](media/index/WritingStyleGuidebanner.png) ## Make every word matter @@ -22,19 +22,14 @@ Today, lots of people are called upon to write about technology. We need a simpl style guide that everyone can use, regardless of their role. And it needs to reflect Microsoft's modern approach to voice and style: warm and relaxed, crisp and clear, and ready to lend a hand. -The *Microsoft Writing Style Guide* replaces the *Microsoft Manual of Style,* a respected source of -editorial guidance for the tech community for more than 20 years. The style guide features updated -direction and new guidance for subjects that weren't around when the last edition released. But it's -also a reimagining of Microsoft style—a tool to help everyone write in a way that's natural, simple, and clear. - -Here's some of what's new in the *Microsoft Writing Style Guide:* +Here's what you will find in the *Microsoft Writing Style Guide:* - [Top 10 tips for mastering Microsoft style and voice](~/top-10-tips-style-voice.md) -- Term collections that consolidate related terms into one handy list, such as [Accessibility terms](~/a-z-word-list-term-collections/term-collections/accessibility-terms.md), [Computer and device terms](~/a-z-word-list-term-collections/term-collections/computer-device-terms.md), [Cloud-computing terms](~/a-z-word-list-term-collections/term-collections/cloud-computing-terms.md), and [Bits and bytes terms](~/a-z-word-list-term-collections/term-collections/bits-bytes-terms.md) +- [Bias-free communication](~/bias-free-communication.md) -- New major topics for [Chatbots and virtual agents](~/chatbots-virtual-agents/index.md), [Content planning](~/content-planning.md), and [Responsive content](~/responsive-content.md) +- [Global communications](~/global-communications/index.md) We welcome your feedback about the *Microsoft Writing Style Guide.* Contact us at <msstyle@microsoft.com>. -© 2019 Microsoft. All rights reserved. +© 2024 Microsoft. All rights reserved. diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md index 6deefc543..8e6a824b9 100644 --- a/styleguide/welcome/whats-new.md +++ b/styleguide/welcome/whats-new.md @@ -1,10 +1,11 @@ --- 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: 9/21/2019 +ms.date: 10/16/2024 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # What's new? @@ -14,54 +15,134 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui | **Date** | **Article** | **Change** | |-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| -| March 31, 2020 | [Capitalization](/styleguide/capitalization.md) | Added guidance for hyphenated compound words | -| March 31, 2020 | [Hyphens](/styleguide/punctuation/dashes-hyphens/hyphens.md) | Updated list of examples. | -| March 31, 2020 | [Later](/styleguide/a-z-word-list-term-collections/l/later.md) | Updated list of examples. | -| March 31, 2020 | [Multifactor authentication](/styleguide/a-z-word-list-term-collections/m/multifactor-authentication.md) | Added guidance for *multifactor authentication*. | -| March 31, 2020 | [Nouns and pronouns](/styleguide/grammar/nouns-pronouns.md) | Added guidance for *they*. | -| March 31, 2020 | [Numbers](/styleguide/numbers.md) | Updated guidance on comma usage. | -| March 31, 2020 | [runs vs. runs on](/styleguide/a-z-word-list-term-collections/r/runs-vs-runs-on.md) | Updated list of examples. | -| March 31, 2020 | [Units of measure terms ](/styleguide/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. | -| 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)<br />[Nouns and pronouns](~/grammar/nouns-pronouns.md) | 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. | +| 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. +| 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. +| April 18, 2024 | [Militaristic language](https://learn.microsoft.com/en-us/style-guide/militaristic-language) | Created new topic with guidelines on avoiding overly violent and militaristic language. +| February 26, 2024 | [see, see also, and similar phrases](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/see-see-also-and-similar-phrases) | Created new topic regarding visual-based phrases and accessibility. +| February 22, 2024 | [Formatting titles](https://learn.microsoft.com/en-us/style-guide/text-formatting/formatting-titles) | Streamlined guidance to generally recommend sentence-casing; updated to recommend bold instead of italics for titles for enhanced readability and accessibility. +| February 22, 2024 | [multi-](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/m/multi) | Updated to only include examples where the MWSG deviates from the American Heritage Dictionary. +| December 22, 2023 | [notification area](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/n/notification-area) | Updated guidance to reflect that this now only applies to OS versions prior to Windows 11. +| December 22, 2023 | [system tray](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/system-tray) | Updated guidance to reflect change with Windows 11. +| November 15, 2023 | [enable, enables](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/e/enable-enables) | Updated guidance to avoid use of enable, provided links to related topics. +| November 15, 2023 | [percent, percent sign (%), percentage](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/p/percent-percentage) | Streamlined guidance, removed examples to focus on exception to the percent rules. +| November 15, 2023 | [Windows 10, Windows 11](https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/w/windows-7-windows-8-windows-10) | Updated guidance and title to reflect the deprecation of Windows 7 and 8. +| June 20, 2023 | [Accessibility terms](https://learn.microsoft.com/style-guide/a-z-word-list-term-collections/term-collections/accessibility-terms) | Updated guidance concerning neurodiversity. +| 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 unconscious 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](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](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](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. | -| December 12, 2018 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md)<br />[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. | +| 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 | [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 | [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. | diff --git a/styleguide/word-choice/avoid-jargon.md b/styleguide/word-choice/avoid-jargon.md index c796cdfcc..38ec10087 100644 --- a/styleguide/word-choice/avoid-jargon.md +++ b/styleguide/word-choice/avoid-jargon.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Avoid jargon 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 ee59b7ac6..70f6cd5ac 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,23 +1,26 @@ --- 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: 01/19/2018 +ms.date: 08/26/2024 ms.topic: article -ms.prod: non-product-specific +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 ([*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 *[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. **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 +28,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. @@ -35,7 +38,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| diff --git a/styleguide/word-choice/index.md b/styleguide/word-choice/index.md index 94da9a4c4..f6b6d0c58 100644 --- a/styleguide/word-choice/index.md +++ b/styleguide/word-choice/index.md @@ -1,10 +1,11 @@ --- 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.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Word choice @@ -23,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/). diff --git a/styleguide/word-choice/use-contractions.md b/styleguide/word-choice/use-contractions.md index b1a526fd7..20f5917d4 100644 --- a/styleguide/word-choice/use-contractions.md +++ b/styleguide/word-choice/use-contractions.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use contractions diff --git a/styleguide/word-choice/use-simple-words-concise-sentences.md b/styleguide/word-choice/use-simple-words-concise-sentences.md index b96eeaeb6..f191f55e5 100644 --- a/styleguide/word-choice/use-simple-words-concise-sentences.md +++ b/styleguide/word-choice/use-simple-words-concise-sentences.md @@ -1,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use simple words, concise sentences diff --git a/styleguide/word-choice/use-technical-terms-carefully.md b/styleguide/word-choice/use-technical-terms-carefully.md index 29440cbd3..d7b1e6377 100644 --- a/styleguide/word-choice/use-technical-terms-carefully.md +++ b/styleguide/word-choice/use-technical-terms-carefully.md @@ -1,10 +1,11 @@ --- 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.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use technical terms carefully @@ -35,9 +36,9 @@ 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/), [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). @@ -61,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/). 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 8fc6b5044..4550bfd66 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,10 +1,11 @@ --- 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 ms.topic: article -ms.prod: non-product-specific +ms.service: microsoft-writing-style-guide --- # Use US spelling and avoid non-English words diff --git a/writing-style-guide-msft-internal/authorize.md b/writing-style-guide-msft-internal/authorize.md new file mode 100644 index 000000000..67f3185d5 --- /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 000000000..64dd157fd --- /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