Add Microsoft style guides and configuration files

Author: meganbradley

.vscode/styles/.vale-config/0-PowerShell-Docs.ini

@@ -0,0 +1,23 @@
+StylesPath = styles
+Packages = Microsoft, alex
+
+[*.md]
+BasedOnStyles = Vale, Microsoft, alex
+
+alex.Ablist = NO                # Doesn't apply to our content
+alex.ProfanityLikely = NO       # Doesn't apply to our content
+alex.ProfanityMaybe = NO        # Doesn't apply to our content
+alex.ProfanityUnlikely = NO     # Doesn't apply to our content
+
+Microsoft.HeadingAcronyms = NO  # Too noisy for our docset
+Microsoft.Headings = NO         # Too noisy for our docset
+Microsoft.Passive = NO          # Too noisy
+Microsoft.Negative = NO         # Prefer to not use endash
+Microsoft.Spacing = NO          # Use PowerShell-Docs rule
+Microsoft.We = NO               # Too noisy when we want to use First Person
+Microsoft.Vocab = NO            # Too noisy
+Microsoft.RangeFormat = NO      # Doesn't apply for markdown
+Microsoft.Ranges = NO           # Doesn't apply for markdown
+Microsoft.GeneralURL = NO       # Doesn't apply for our audience
+
+; PowerShell-Docs.Passive = NO    # Too noisy

.vscode/styles/Microsoft/Gender.yml

@@ -0,0 +1,8 @@
+extends: existence
+message: "Don't use '%s'."
+link: https://github.com/MicrosoftDocs/microsoft-style-guide/blob/master/styleguide/grammar/nouns-pronouns.md#pronouns-and-gender
+level: error
+ignorecase: true
+tokens:
+  - he/she
+  - s/he

.vscode/styles/Microsoft/GenderBias.yml

@@ -0,0 +1,42 @@
+extends: substitution
+message: "Consider using '%s' instead of '%s'."
+ignorecase: true
+level: error
+action:
+  name: replace
+swap:
+  (?:alumna|alumnus): graduate
+  (?:alumnae|alumni): graduates
+  air(?:m[ae]n|wom[ae]n): pilot(s)
+  anchor(?:m[ae]n|wom[ae]n): anchor(s)
+  authoress: author
+  camera(?:m[ae]n|wom[ae]n): camera operator(s)
+  door(?:m[ae]|wom[ae]n): concierge(s)
+  draft(?:m[ae]n|wom[ae]n): drafter(s)
+  fire(?:m[ae]n|wom[ae]n): firefighter(s)
+  fisher(?:m[ae]n|wom[ae]n): fisher(s)
+  fresh(?:m[ae]n|wom[ae]n): first-year student(s)
+  garbage(?:m[ae]n|wom[ae]n): waste collector(s)
+  lady lawyer: lawyer
+  ladylike: courteous
+  mail(?:m[ae]n|wom[ae]n): mail carriers
+  man and wife: husband and wife
+  man enough: strong enough
+  mankind: human kind
+  manmade: manufactured
+  manpower: personnel
+  middle(?:m[ae]n|wom[ae]n): intermediary
+  news(?:m[ae]n|wom[ae]n): journalist(s)
+  ombuds(?:man|woman): ombuds
+  oneupmanship: upstaging
+  poetess: poet
+  police(?:m[ae]n|wom[ae]n): police officer(s)
+  repair(?:m[ae]n|wom[ae]n): technician(s)
+  sales(?:m[ae]n|wom[ae]n): salesperson or sales people
+  service(?:m[ae]n|wom[ae]n): soldier(s)
+  steward(?:ess)?: flight attendant
+  tribes(?:m[ae]n|wom[ae]n): tribe member(s)
+  waitress: waiter
+  woman doctor: doctor
+  woman scientist[s]?: scientist(s)
+  work(?:m[ae]n|wom[ae]n): worker(s)

.vscode/styles/Microsoft/GeneralURL.yml

@@ -0,0 +1,11 @@
+extends: existence
+message: "For a general audience, use 'address' rather than 'URL'."
+link: https://docs.microsoft.com/en-us/style-guide/urls-web-addresses
+level: warning
+action:
+  name: replace
+  params:
+    - URL
+    - address
+tokens:
+  - URL

.vscode/styles/Microsoft/Percentages.yml

@@ -0,0 +1,7 @@
+extends: existence
+message: "Use a numeral plus the units."
+link: https://docs.microsoft.com/en-us/style-guide/numbers
+nonword: true
+level: error
+tokens:
+  - '\b[a-zA-z]+\spercent\b'

ThirdPartyNotices.md

@@ -8,7 +8,8 @@ see the [LICENSE][05] file, and grant you a license to any code in the repositor
 Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the
 documentation may be either trademarks or registered trademarks of Microsoft in the United States
 and/or other countries. The licenses for this project do not grant you rights to use any Microsoft
-names, logos, or trademarks. You can find Microsoft general trademark guidelines at [Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks).
+names, logos, or trademarks. You can find Microsoft general trademark guidelines at 
+[Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks).
 
 For privacy information, see [privacy at Microsoft](https://privacy.microsoft.com/en-us/).