Change H2 case in about articles (#12391)

* Upcase H2 headers

* Fix structure of About files

* Change H2 case in about articles

* Fix bookmarks

Author: sdwheeler

reference/5.1/Microsoft.PowerShell.Core/About/about_ANSI_Terminals.md

@@ -7,17 +7,18 @@ title: about_ANSI_Terminals
 ---
 # about_ANSI_Terminals
 
-## SHORT DESCRIPTION
+## Short description
+
 Describes the support available for ANSI escape sequences in Windows PowerShell.
 
-## LONG DESCRIPTION
+## Long description
 
 Unlike newer versions of PowerShell, the Windows PowerShell 5.1 engine and core
 cmdlets don't output ANSI escape sequences to format the text displayed on your
 screen. However, that doesn't prevent you from using ANSI escape sequences for
 text formatting in terminals that support it.
 
-## ANSI TERMINAL SUPPORT
+## ANSI Terminal support
 
 On Windows 10 and higher, the Windows Console Host is [xterm][02] compatible.
 The [Windows Terminal][03] application is also xterm compatible. These
@@ -31,7 +32,7 @@ The default colors were chosen for use with terminals that have a dark
 background. You can change the colors needed for your environment. For more
 information, see [Customizing your shell experience][01].
 
-## REDIRECTING OUTPUT
+## Redirecting output
 
 You should be careful about creating output that's decorated with ANSI escape
 sequences. The formatting is intended for display in the terminal. When you

reference/5.1/Microsoft.PowerShell.Core/About/about_Alias_Provider.md

@@ -9,23 +9,19 @@ title: about_Alias_Provider
 ---
 # about_Alias_Provider
 
-## PROVIDER NAME
+## Provider name
 
 Alias
 
-## DRIVES
+## Drives
 
 `Alias:`
 
-## CAPABILITIES
+## Capabilities
 
 **ShouldProcess**
 
-## SHORT DESCRIPTION
-
-Provides access to the PowerShell aliases and the values that they represent.
-
-## DETAILED DESCRIPTION
+## Detailed description
 
 The PowerShell **Alias** provider lets you get, add, change, clear, and delete
 aliases in PowerShell.
@@ -58,12 +54,12 @@ cmdlets.
 - [New-Alias][10]
 - [Set-Alias][11]
 
-## TYPES EXPOSED BY THIS PROVIDER
+## Types exposed by this provider
 
 Each alias is an instance of the [System.Management.Automation.AliasInfo][12]
 class.
 
-## NAVIGATING THE ALIAS DRIVE
+## Navigating the alias drive
 
 The **Alias** provider exposes its data store in the `Alias:` drive. To work
 with aliases, you can change your location to the `Alias:` drive by using the
@@ -86,8 +82,8 @@ path.
 > [!NOTE]
 > PowerShell uses aliases to allow you a familiar way to work with provider
 > paths. Commands such as `dir` and `ls` are now aliases for
-> [Get-ChildItem][13], `cd` is an alias for [Set-Location][02], and `pwd` is an
-> alias for [Get-Location][01].
+> [Get-ChildItem][13], `cd` is an alias for [Set-Location][02], and `pwd` is
+> an alias for [Get-Location][01].
 
 ### Displaying the Contents of the Alias: drive
 
@@ -139,7 +135,7 @@ cmdlet name.
 Get-Item -Path Alias:* | Where-Object {$_.Definition -eq "Get-ChildItem"}
 ```
 
-## CREATING ALIASES
+## Creating aliases
 
 ### Create an alias from the Alias: drive
 
@@ -181,7 +177,7 @@ function CD32 {Set-Location -Path C:\windows\system32}
 Set-Item -Path Alias:go -Value CD32
 ```
 
-## CHANGING ALIASES
+## Changing aliases
 
 ### Change the options of an alias
 
@@ -226,7 +222,7 @@ This command uses the `Rename-Item` cmdlet to change the `popd` alias to `pop`.
 Rename-Item -Path Alias:popd -NewName pop
 ```
 
-## COPYING AN ALIAS
+## Copying an alias
 
 This command copies the `pushd` alias so that a new `push` alias is created for
 the `Push-Location` cmdlet.
@@ -240,7 +236,7 @@ the `-Path` parameter.
 Copy-Item -Path Alias:pushd -Destination Alias:push
 ```
 
-## DELETING AN ALIAS
+## Deleting an alias
 
 This command deletes the `serv` alias from the current session.
 You can use this command in any PowerShell drive.
@@ -267,7 +263,7 @@ allows the command to delete aliases whose **Options** property has a value of
 Remove-Item Alias:* -Force
 ```
 
-## DYNAMIC PARAMETERS
+## Dynamic parameters
 
 Dynamic parameters are cmdlet parameters that are added by a PowerShell
 provider and are available only when the cmdlet is being used in the
@@ -292,14 +288,14 @@ Determines the value of the **Options** property of an alias.
 - [New-Item][04]
 - [Set-Item][14]
 
-## USING THE PIPELINE
+## Using the pipeline
 
 Provider cmdlets accept pipeline input. You can use the pipeline to simplify
 task by sending provider data from one cmdlet to another provider cmdlet.
 To read more about how to use the pipeline with provider cmdlets, see the
 cmdlet references provided throughout this article.
 
-## GETTING HELP
+## Getting help
 
 Beginning in Windows PowerShell 3.0, you can get customized help topics for
 provider cmdlets that explain how those cmdlets behave in a file system drive.
@@ -316,7 +312,7 @@ Get-Help Get-ChildItem
 Get-Help Get-ChildItem -Path Alias:
 ```
 
-## SEE ALSO
+## See also
 
 - [about_Aliases][16]
 - [about_Providers][17]

reference/5.1/Microsoft.PowerShell.Core/About/about_Aliases.md

@@ -9,11 +9,11 @@ title: about_Aliases
 ---
 # about_Aliases
 
-## SHORT DESCRIPTION
+## Short description
 
 Describes how to use alternate names for cmdlets and commands in PowerShell.
 
-## LONG DESCRIPTION
+## Long description
 
 An alias is an alternate name or nickname for a cmdlet or for a command
 element, such as a function, script, file, or executable file. You can use the
@@ -47,7 +47,7 @@ If you create `word` as the alias for Microsoft Office Word, you can type
 "C:\Program Files\Microsoft Office\Office11\Winword.exe"
 ```
 
-## BUILT-IN ALIASES
+## Built-in aliases
 
 PowerShell includes a set of built-in aliases, including `cd` and `chdir` for
 the `Set-Location` cmdlet, and `ls` and `dir` for the `Get-ChildItem` cmdlet.
@@ -58,7 +58,7 @@ To get all the aliases on the computer, including the built-in aliases, type:
 Get-Alias
 ```
 
-## ALIAS CMDLETS
+## Alias cmdlets
 
 PowerShell includes the following cmdlets, which are designed for working with
 aliases:
@@ -117,7 +117,7 @@ For more information, type:
 Get-Help about_Profiles
 ```
 
-## GETTING ALIASES
+## Getting aliases
 
 To get all the aliases in the current session, including the built-in aliases,
 the aliases in your PowerShell profiles, and the aliases that you have created
@@ -164,7 +164,7 @@ hyphen. These are likely to be preferred substitute names for cmdlets and
 functions, instead of typical abbreviations or nicknames, and the author might
 not want them to be as evident.
 
-## ALTERNATE NAMES FOR COMMANDS WITH PARAMETERS
+## Alternate names for commands with parameters
 
 You can assign an alias to a cmdlet, script, function, or executable file. You
 cannot assign an alias to a command and its parameters. For example, you can
@@ -192,7 +192,7 @@ For more information about functions, type:
 Get-Help about_Functions
 ```
 
-## ALIAS OBJECTS
+## Alias objects
 
 PowerShell aliases are represented by objects that are instances of the
 System.Management.Automation.AliasInfo class. For more information about this
@@ -216,7 +216,7 @@ the `dir` alias. The following command performs these tasks:
 Get-Alias -Name dir | Format-List -Property *
 ```
 
-## POWERSHELL ALIAS PROVIDER
+## PowerShell Alias provider
 
 PowerShell includes the Alias provider. The Alias provider lets you view the
 aliases in PowerShell as though they were on a file system drive.
@@ -255,7 +255,7 @@ For more information about the PowerShell Alias provider, type:
 Get-Help Alias
 ```
 
-## SEE ALSO
+## See also
 
 - [about_Functions](about_Functions.md)
 - [about_Profiles](about_Profiles.md)

reference/5.1/Microsoft.PowerShell.Core/About/about_Arithmetic_Operators.md

@@ -8,11 +8,11 @@ title: about_Arithmetic_Operators
 ---
 # about_Arithmetic_Operators
 
-## SHORT DESCRIPTION
+## Short description
 
 Describes the operators that perform arithmetic in PowerShell.
 
-## LONG DESCRIPTION
+## Long description
 
 Arithmetic operators calculate numeric values. You can use one or more
 arithmetic operators to add, subtract, multiply, and divide values, and to
@@ -631,7 +631,7 @@ unsigned values, a zero is inserted in the left-most position.
 |      `(-21 -shr 1)`      |         -11 | 11111111111111111111111111110101 | 0xFFFFFFF5 |
 |      `(-21 -shr 2)`      |          -6 | 11111111111111111111111111111010 | 0xFFFFFFF4 |
 
-## SEE ALSO
+## See also
 
 - [about_Arrays](about_Arrays.md)
 - [about_Hash_Tables](about_Hash_Tables.md)

reference/5.1/Microsoft.PowerShell.Core/About/about_Arrays.md

@@ -9,20 +9,20 @@ title: about_Arrays
 ---
 # about_Arrays
 
-## SHORT DESCRIPTION
+## Short description
 
 Describes arrays, which are data structures designed to store collections of
 items.
 
-## LONG DESCRIPTION
+## Long description
 
 An array is a data structure that's designed to store a collection of items.
 The items can be the same type or different types.
 
 Beginning in Windows PowerShell 3.0, a collection of zero or one object has
 some properties of arrays.
 
-## CREATING AND INITIALIZING AN ARRAY
+## Creating and initializing an array
 
 To create and initialize an array, assign multiple values to a variable. The
 values stored in the array are delimited with a comma and separated from the
@@ -82,7 +82,7 @@ process objects, enter the following command:
 [Diagnostics.Process[]]$zz = Get-Process
 ```
 
-## THE ARRAY SUB-EXPRESSION OPERATOR
+## The array subexpression operator
 
 The array sub-expression operator creates an array from the statements inside
 it. Whatever the statement inside the operator produces, the operator places it
@@ -125,7 +125,7 @@ $p = @(Get-Process Notepad)
 For more information about the array sub-expression operator, see
 [about_Operators][11].
 
-## ACCESSING AND USING ARRAY ELEMENTS
+## Accessing and using array elements
 
 ### Reading an array
 
@@ -338,7 +338,7 @@ while($i -lt 4) {
 3
 ```
 
-## PROPERTIES OF ARRAYS
+## Properties of arrays
 
 ### Count or Length or LongLength
 
@@ -463,7 +463,7 @@ True
 40
 ```
 
-## METHODS OF ARRAYS
+## Methods of arrays
 
 ### Clear
 
@@ -803,7 +803,7 @@ Stopped  AppIDSvc           Application Identity
 > Both `ForEach()` and `Where()` methods are intrinsic members. For more
 > information about intrinsic members, see [about_Intrinsic_Members][08].
 
-## GET THE MEMBERS OF AN ARRAY
+## Get the members of an array
 
 To get the properties and methods of an array, such as the **Length** property
 and the **SetValue** method, use the **InputObject** parameter of the
@@ -833,7 +833,7 @@ and `Get-Member` returns the members of the array. Like the next two examples.
 ,(1,2,3) | Get-Member
 ```
 
-## MANIPULATING AN ARRAY
+## Manipulating an array
 
 You can change the elements in an array, add an element to an array, and
 combine the values from two arrays into a third array.
@@ -899,7 +899,7 @@ command deletes the array in the `$a` variable.
 You can also use the `Remove-Item` cmdlet, but assigning a value of `$null` is
 faster, especially for large arrays.
 
-## ARRAYS OF ZERO OR ONE
+## Arrays of zero or one
 
 Beginning in Windows PowerShell 3.0, a scalar types and collection of zero or
 one objects has the **Count** and **Length** properties. Also, you can use
@@ -984,7 +984,7 @@ PS> $result[0].Length
 
 
 
-## INDEXING .NET TYPES THAT IMPLEMENT `IDICTIONARY<TKEY, TVALUE>`
+## Indexing .NET types that implement `IDictionary<TKey, TValue>`
 
 PowerShell doesn't call a type's true indexer for types that implement the
 generic `IDictionary<TKey, TValue>` interface. Instead, when given a key,
@@ -1009,7 +1009,7 @@ At line:1 char:1
 + FullyQualifiedErrorId : ExceptionWhenGetting
 ```
 
-## MEMBER-ACCESS ENUMERATION
+## Member-access enumeration
 
 Starting in PowerShell 3.0, when you use the member-access operator to access a
 member that doesn't exist on a list collection, PowerShell automatically
@@ -1090,7 +1090,7 @@ LastWriteTimeUtc  Property   datetime LastWriteTimeUtc {get;set;}
 > Since the method is executed for each item in the collection, care should be
 > taken when calling methods using member enumeration.
 
-## SEE ALSO
+## See also
 
 - [about_For][05]
 - [about_Foreach][06]