(AB-568561) [switch] parameter in about topics

Author: michaeltlombardi

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

@@ -198,19 +198,18 @@ The syntax diagrams use the following symbols:
 - Parameters with no values
 
   Some parameters don't accept input, so they don't have a parameter value.
-  Parameters without values are _switch parameters_. Switch parameters are used
-  like boolean values. They default to `$false`. When you use a switch
-  parameter, the value is set to `$true`.
+  Parameters without values are _`[switch]` parameters_. `[switch]` parameters
+  are used like boolean values. They default to `$false`. When you use a
+  `[switch]` parameter, the value is set to `$true`.
 
-  For example, the **ListImported** parameter of `Get-Command` is a switch
+  For example, the **ListImported** parameter of `Get-Command` is a `[switch]`
   parameter. When you use the **ListImported** parameter, the cmdlet return
   only commands that were imported from modules in the current session.
 
   ```Syntax
   Get-Command [-ListImported]
   ```
 
-<!-- So what are these `[    ]`? - square brackets, duh! -->
 - Brackets `[  ]` around parameters indicate optional items. A parameter and
   its value can be optional. For example, the **CommandType** parameter of
   `Get-Command` and its value are enclosed in brackets because they're both

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

@@ -239,7 +239,7 @@ For more information about the standard PowerShell verbs, see
 ## Functions with parameters
 
 You can use parameters with functions, including named parameters, positional
-parameters, switch parameters, and dynamic parameters. For more information
+parameters, `[switch]` parameters, and dynamic parameters. For more information
 about dynamic parameters in functions, see
 [about_Functions_Advanced_Parameters][09].
 
@@ -379,13 +379,12 @@ Get-Extension myTextFile
 myTextFile.txt
 ```
 
-### Switch parameters
+### `[switch]` parameters
 
 A switch is a parameter that doesn't require a value. Instead, you type the
-function name followed by the name of the switch parameter.
+function name followed by the name of the `[switch]` parameter.
 
-To define a switch parameter, specify the type `[switch]` before the parameter
-name, as shown in the following example:
+The following example shows how you define a `[switch]` parameter:
 
 ```powershell
 function Switch-Item {
@@ -395,8 +394,9 @@ function Switch-Item {
 }
 ```
 
-When you type the `On` switch parameter after the function name, the function
-displays `Switch on`. Without the switch parameter, it displays `Switch off`.
+When you type the `On` `[switch]` parameter after the function name, the
+function displays `Switch on`. Without the `[switch]` parameter, it displays
+`Switch off`.
 
 ```powershell
 Switch-Item -On

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

@@ -104,8 +104,8 @@ $PSDefaultParameterValues = @{
 ```
 
 The cmdlet and parameter names can contain wildcard characters. Use `$true` and
-`$false` to set values for switch parameters, such as **Verbose**. This example
-sets the common parameter **Verbose** to `$true` for all commands.
+`$false` to set values for `[switch]` parameters, such as **Verbose**. This
+example sets the common parameter **Verbose** to `$true` for all commands.
 
 ```powershell
 $PSDefaultParameterValues = @{'*:Verbose'=$true}
@@ -162,9 +162,9 @@ You can use a scriptblock to specify different default values for a parameter
 under different conditions. PowerShell evaluates the scriptblock and uses the
 result as the default parameter value.
 
-The `Format-Table:AutoSize` key sets that switch parameter to a default value
-of `$true` The `if` statement contains a condition that the `$Host.Name` must
-be `ConsoleHost`.
+The `Format-Table:AutoSize` key sets that `[switch]` parameter to a default
+value of `$true` The `if` statement contains a condition that the `$Host.Name`
+must be `ConsoleHost`.
 
 ```powershell
 $PSDefaultParameterValues = @{

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

@@ -211,11 +211,11 @@ For example:
 
 #### -RunAsAdministrator
 
-When this switch parameter is added to your `#Requires` statement, it specifies
-that the PowerShell session in which you're running the script must be started
-with elevated user rights. The **RunAsAdministrator** parameter is ignored on a
-non-Windows operating system. The **RunAsAdministrator** parameter was
-introduced in PowerShell 4.0.
+When this `[switch]` parameter is added to your `#Requires` statement, it
+specifies that the PowerShell session in which you're running the script must
+be started with elevated user rights. The **RunAsAdministrator** parameter is
+ignored on a non-Windows operating system. The **RunAsAdministrator** parameter
+was introduced in PowerShell 4.0.
 
 For example:
 

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

@@ -49,7 +49,7 @@ command so you don't pass more than one value for each parameter.
 ## Splatting with hash tables
 
 Use a hash table to splat parameter name and value pairs. You can use this
-format for all parameter types, including positional and switch parameters.
+format for all parameter types, including positional and `[switch]` parameters.
 Positional parameters must be assigned by name.
 
 The following examples compare two `Copy-Item` commands that copy the Test.txt
@@ -68,7 +68,7 @@ table of parameter-name and parameter-value pairs and stores it in the
 variable in a command with splatting. The At symbol (`@HashArguments`) replaces
 the dollar sign (`$HashArguments`) in the command.
 
-To provide a value for the **WhatIf** switch parameter, use `$true` or
+To provide a value for the **WhatIf** `[switch]` parameter, use `$true` or
 `$false`.
 
 ```powershell

reference/7.4/Microsoft.PowerShell.Core/About/about_Command_Syntax.md

@@ -198,19 +198,18 @@ The syntax diagrams use the following symbols:
 - Parameters with no values
 
   Some parameters don't accept input, so they don't have a parameter value.
-  Parameters without values are _switch parameters_. Switch parameters are used
-  like boolean values. They default to `$false`. When you use a switch
-  parameter, the value is set to `$true`.
+  Parameters without values are _`[switch]` parameters_. `[switch]` parameters
+  are used like boolean values. They default to `$false`. When you use a
+  `[switch]` parameter, the value is set to `$true`.
 
-  For example, the **ListImported** parameter of `Get-Command` is a switch
+  For example, the **ListImported** parameter of `Get-Command` is a `[switch]`
   parameter. When you use the **ListImported** parameter, the cmdlet return
   only commands that were imported from modules in the current session.
 
   ```Syntax
   Get-Command [-ListImported]
   ```
 
-<!-- So what are these `[    ]`? - square brackets, duh! -->
 - Brackets `[  ]` around parameters indicate optional items. A parameter and
   its value can be optional. For example, the **CommandType** parameter of
   `Get-Command` and its value are enclosed in brackets because they're both

reference/7.4/Microsoft.PowerShell.Core/About/about_Functions.md

@@ -263,7 +263,7 @@ For more information about the standard PowerShell verbs, see
 ## Functions with parameters
 
 You can use parameters with functions, including named parameters, positional
-parameters, switch parameters, and dynamic parameters. For more information
+parameters, `[switch]` parameters, and dynamic parameters. For more information
 about dynamic parameters in functions, see
 [about_Functions_Advanced_Parameters][09].
 
@@ -403,13 +403,12 @@ Get-Extension myTextFile
 myTextFile.txt
 ```
 
-### Switch parameters
+### `[switch]` parameters
 
 A switch is a parameter that doesn't require a value. Instead, you type the
-function name followed by the name of the switch parameter.
+function name followed by the name of the `[switch]` parameter.
 
-To define a switch parameter, specify the type `[switch]` before the parameter
-name, as shown in the following example:
+The following example shows how you define a `[switch]` parameter:
 
 ```powershell
 function Switch-Item {
@@ -419,8 +418,9 @@ function Switch-Item {
 }
 ```
 
-When you type the `On` switch parameter after the function name, the function
-displays `Switch on`. Without the switch parameter, it displays `Switch off`.
+When you type the `On` `[switch]` parameter after the function name, the
+function displays `Switch on`. Without the `[switch]` parameter, it displays
+`Switch off`.
 
 ```powershell
 Switch-Item -On

reference/7.4/Microsoft.PowerShell.Core/About/about_Parameters_Default_Values.md

@@ -104,8 +104,8 @@ $PSDefaultParameterValues = @{
 ```
 
 The cmdlet and parameter names can contain wildcard characters. Use `$true` and
-`$false` to set values for switch parameters, such as **Verbose**. This example
-sets the common parameter **Verbose** to `$true` for all commands.
+`$false` to set values for `[switch]` parameters, such as **Verbose**. This
+example sets the common parameter **Verbose** to `$true` for all commands.
 
 ```powershell
 $PSDefaultParameterValues = @{'*:Verbose'=$true}
@@ -162,9 +162,9 @@ You can use a scriptblock to specify different default values for a parameter
 under different conditions. PowerShell evaluates the scriptblock and uses the
 result as the default parameter value.
 
-The `Format-Table:AutoSize` key sets that switch parameter to a default value
-of `$true` The `if` statement contains a condition that the `$Host.Name` must
-be `ConsoleHost`.
+The `Format-Table:AutoSize` key sets that `[switch]` parameter to a default
+value of `$true` The `if` statement contains a condition that the `$Host.Name`
+must be `ConsoleHost`.
 
 ```powershell
 $PSDefaultParameterValues = @{

reference/7.4/Microsoft.PowerShell.Core/About/about_PowerShell_Editions.md

@@ -198,8 +198,8 @@ Get-Module -ListAvailable BitsTransfer
 # No output
 ```
 
-In both cases, the `-SkipEditionCheck` switch parameter can be used to override
-this behavior:
+In both cases, the `-SkipEditionCheck` `[switch]` parameter can be used to
+override this behavior:
 
 ```powershell
 Get-Module -ListAvailable -SkipEditionCheck BitsTransfer

reference/7.4/Microsoft.PowerShell.Core/About/about_Pwsh.md

@@ -69,15 +69,15 @@ and any parameters. File must be the last parameter in the command, because all
 characters typed after the File parameter name are interpreted as the script
 filepath followed by the script parameters.
 
-Typically, the switch parameters of a script are either included or omitted.
-For example, the following command uses the **All** parameter of the
+Typically, the `[switch]` parameters of a script are either included or
+omitted. For example, the following command uses the **All** parameter of the
 `Get-Script.ps1` script file: `-File .\Get-Script.ps1 -All`
 
-In rare cases, you might need to provide a **Boolean** value for a switch
-parameter. To provide a **Boolean** value for a switch parameter in the value
-of the **File** parameter, Use the parameter normally followed immediately by a
-colon and the boolean value, such as the following:
-`-File .\Get-Script.ps1 -All:$false`.
+In rare cases, you might need to provide a **Boolean** value for a `[switch]`
+parameter. To provide a **Boolean** value for a `[switch]` parameter in the
+value of the **File** parameter, Use the parameter normally followed
+immediately by a colon and the boolean value, such as the following: `-File
+.\Get-Script.ps1 -All:$false`.
 
 Parameters passed to the script are passed as literal strings, after
 interpretation by the current shell. For example, if you are in `cmd.exe` and