diff --git a/styleguide/a-z-word-list-term-collections/d/devops.md b/styleguide/a-z-word-list-term-collections/d/devops.md index d8273a62..f45a964e 100644 --- a/styleguide/a-z-word-list-term-collections/d/devops.md +++ b/styleguide/a-z-word-list-term-collections/d/devops.md @@ -1,6 +1,6 @@ --- title: DevOps - Microsoft Style Guide -description: Describes guidelines to use 'DevOps' in Microsoft Docs. Carefully note spelling and capitalization. +description: Describes guidelines to use 'DevOps' in Microsoft documents. Carefully note spelling and capitalization. author: pallep ms.author: pallep ms.date: 01/19/2018 diff --git a/styleguide/developer-content/reference-documentation.md b/styleguide/developer-content/reference-documentation.md index df9b8bef..8f2af6f5 100644 --- a/styleguide/developer-content/reference-documentation.md +++ b/styleguide/developer-content/reference-documentation.md @@ -72,4 +72,4 @@ If you automatically generate reference documentation and comments from the sour quality and appropriateness of the comments. Developers might leave out details that are important to customers. Remove any implementation or internal details that aren't suitable for documentation. -**Learn more** For other examples of technical reference articles, see the [.NET API Browser](/dotnet/api/?view=netframework-4.7.1&preserve-view=true) section of [Microsoft Docs](/documentation). +**Learn more** For other examples of technical reference articles, see the [.NET API Browser](/dotnet/api/?view=netframework-4.7.1&preserve-view=true). diff --git a/styleguide/grammar/nouns-pronouns.md b/styleguide/grammar/nouns-pronouns.md index 02e853c7..295a41ce 100644 --- a/styleguide/grammar/nouns-pronouns.md +++ b/styleguide/grammar/nouns-pronouns.md @@ -47,7 +47,7 @@ Capitalize technology terms as proper nouns only when: If you're not sure whether a term is a proper noun (and thus capitalized) or a common noun (lowercase), check *[The American Heritage Dictionary](https://ahdictionary.com/)* and the A–Z word list. Default to lowercase unless there's a compelling reason to capitalize the term. -**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](https://docs.microsoft.com/en-us/style-guide/grammar/person). +**Learn more** For guidelines for sentence-style and title-style capitalization, see [Capitalization](/style-guide/grammar/person). ## Plural nouns @@ -76,7 +76,7 @@ you're writing about real people who use those pronouns themselves. *They* can be used as a non-binary pronoun for a singular person instead of a binary pronoun (*she* or *he*). -For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](https://docs.microsoft.com/en-us/style-guide/bias-free-communication). +For more guidelines about how to write using gender-neutral pronouns, see [Bias-free communication](/style-guide/bias-free-communication). ## Pronouns and collective nouns @@ -87,4 +87,4 @@ Collective nouns like *company* take a singular pronoun. Don't use a plural pron ## Using pronouns in product UI -See also [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person). +See also [Person](/style-guide/grammar/person). diff --git a/styleguide/welcome/whats-new.md b/styleguide/welcome/whats-new.md index f069c5d2..2539ecad 100644 --- a/styleguide/welcome/whats-new.md +++ b/styleguide/welcome/whats-new.md @@ -15,10 +15,10 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui | **Date** | **Article** | **Change** | |-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| -| June 24, 2022 | [Date and time terms](https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time). -| June 24, 2022 | [Colons](https://docs.microsoft.com/en-us/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time). -| June 24, 2022 | [Nouns and pronouns](https://docs.microsoft.com/en-us/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI. -| June 24, 2022 | [Person](https://docs.microsoft.com/en-us/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content. +| June 24, 2022 | [Date and time terms](/style-guide/a-z-word-list-term-collections/term-collections/date-time-terms) | Reverted guidance (removed mention of ratio symbol in clock time). +| June 24, 2022 | [Colons](/style-guide/punctuation/colons) | Reverted guidance (removed mention of ratio symbol in clock time). +| June 24, 2022 | [Nouns and pronouns](/style-guide/grammar/nouns-pronouns) | Added guidance regarding capitalization of proper nouns; added link to Person section for discussion of using pronouns in product UI. +| June 24, 2022 | [Person](/style-guide/grammar/person) | Revised guidance to move away from first-person singular pronouns (with one notable exception when distinguishing ownership of content in shared visual space); updated examples for use of first- and second-person pronouns to reflect more use cases in UI; added guidance about pronouns in AI-generated content. | May 13, 2022 | [Lists](/style-guide/scannable-content/lists) | Added another example of a bulleted list. Expanded the Exception and added examples. to address gap in guidance regarding lists that do not complete an introductory phrase, but whose items are all short, complete sentences. | May 13, 2022 | [Periods](/style-guide/punctuation/periods) | Added link to Lists topic in guidance. | May 13, 2022 | [Numbers](/style-guide/numbers) | Added new section on phone numbers. @@ -75,7 +75,7 @@ This table shows a history of recent updates to the *Microsoft Writing Style Gui | March 31, 2020 | [Nouns and pronouns](~/grammar/nouns-pronouns.md) | Added guidance for *they*. | | March 31, 2020 | [Numbers](~/numbers.md) | Updated guidance on comma usage. | | March 31, 2020 | [runs vs. runs on](~/a-z-word-list-term-collections/r/runs-vs-runs-on.md) | Updated list of examples. | -| March 31, 2020 | [Units of measure terms ](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) | Updated examples on Speed frequency. Also updated comma exceptions and examples. | +| March 31, 2020 | [Units of measure terms](~/a-z-word-list-term-collections/term-collections/units-of-measure-terms.md) | Updated examples on Speed frequency. Also updated comma exceptions and examples. | | September 21, 2019 | [Mouse and mouse interaction term collection](~/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms.md) | Added guidance for *scroll.* | | September 21, 2019 | [Start button, Start menu](~/a-z-word-list-term-collections/s/start-button-start-menu.md) | Updated the guideline for when to use bold formatting for *Start.* | | September 21, 2019 | [Describing interactions with UI](~/procedures-instructions/describing-interactions-with-ui.md) | Deleted *press and hold.* Clarified that *select and hold* is the correct term to use to describe pressing and holding a UI element. Added examples. |