Improve Get-Process Ex 4 Priority grouping

The Priority table view for Diagnostics.Process groups on the
PriorityClass property. Format-Table expects input to already be
sorted, but the original example used unsorted data, rendering it
fairly unhelpful.

This adds a call to Sort-Object and sorts on PriorityClass before
calling Format-Table. This ensures all processes are correctly grouped
by the Priority view. A script block is used in lieu of the property
name directly, as the latter surfaces getter exceptions as a
non-terminating error. This will occur with, e.g., PPL processes in
Windows (even when elevated).

Reference to PS home directory .ps1xml files is also removed from the
v7.x docs. Format definitions were moved directly into source code in
v6+.

As a Format-* cmdlet is used, the term "display" is used to emphasize
output is not intended for further processing.

Author: surfingoldelephant

reference/5.1/Microsoft.PowerShell.Management/Get-Process.md

@@ -113,21 +113,22 @@ objects to the `Where-Object` cmdlet, which selects only the object with a value
 `Get-Process | Get-Member`. By default, the values of all amount properties are in bytes, even
 though the default display lists them in kilobytes and megabytes.
 
-### Example 4: List processes on the computer in groups based on priority
+### Example 4: Display processes on the computer in groups based on priority
 
 ```powershell
-$A = Get-Process
-$A | Get-Process | Format-Table -View Priority
+$processes = Get-Process
+$processes | Sort-Object { $_.PriorityClass } | Format-Table -View Priority
 ```
 
-These commands list the processes on the computer in groups based on their priority class. The first
-command gets all the processes on the computer and then stores them in the `$A` variable.
+These commands display processes on the computer in groups based on their
+[priority class](/dotnet/api/system.diagnostics.processpriorityclass). The first command gets all
+processes on the computer and stores them in the `$processes` variable.
 
-The second command pipes the **Process** object stored in the `$A` variable to the `Get-Process`
-cmdlet, then to the `Format-Table` cmdlet, which formats the processes by using the **Priority**
-view.
+The second command pipes the **Process** objects stored in the `$processes` variable to the
+`Sort-Object` cmdlet, then to the `Format-Table` cmdlet, which formats the processes using the
+**Priority** view.
 
-The **Priority** view, and other views, are defined in the PS1XML format files in the PowerShell
+The **Priority** view, and other views, are defined in the `.ps1xml` format files in the PowerShell
 home directory (`$PSHOME`).
 
 ### Example 5: Add a property to the standard Get-Process output display

reference/7.4/Microsoft.PowerShell.Management/Get-Process.md

@@ -110,22 +110,20 @@ objects to the `Where-Object` cmdlet, which selects only the object with a value
 `Get-Process | Get-Member`. By default, the values of all amount properties are in bytes, even
 though the default display lists them in kilobytes and megabytes.
 
-### Example 4: List processes on the computer in groups based on priority
+### Example 4: Display processes on the computer in groups based on priority
 
 ```powershell
-$A = Get-Process
-$A | Get-Process | Format-Table -View Priority
+$processes = Get-Process
+$processes | Sort-Object { $_.PriorityClass } | Format-Table -View Priority
 ```
 
-These commands list the processes on the computer in groups based on their priority class. The first
-command gets all the processes on the computer and then stores them in the `$A` variable.
+These commands display processes on the computer in groups based on their
+[priority class](/dotnet/api/system.diagnostics.processpriorityclass). The first command gets all
+processes on the computer and stores them in the `$processes` variable.
 
-The second command pipes the **Process** object stored in the `$A` variable to the `Get-Process`
-cmdlet, then to the `Format-Table` cmdlet, which formats the processes by using the **Priority**
-view.
-
-The **Priority** view, and other views, are defined in the PS1XML format files in the PowerShell
-home directory (`$PSHOME`).
+The second command pipes the **Process** objects stored in the `$processes` variable to the
+`Sort-Object` cmdlet, then to the `Format-Table` cmdlet, which formats the processes using the
+**Priority** view.
 
 ### Example 5: Add a property to the standard Get-Process output display
 

reference/7.5/Microsoft.PowerShell.Management/Get-Process.md

@@ -110,22 +110,20 @@ objects to the `Where-Object` cmdlet, which selects only the object with a value
 `Get-Process | Get-Member`. By default, the values of all amount properties are in bytes, even
 though the default display lists them in kilobytes and megabytes.
 
-### Example 4: List processes on the computer in groups based on priority
+### Example 4: Display processes on the computer in groups based on priority
 
 ```powershell
-$A = Get-Process
-$A | Get-Process | Format-Table -View Priority
+$processes = Get-Process
+$processes | Sort-Object { $_.PriorityClass } | Format-Table -View Priority
 ```
 
-These commands list the processes on the computer in groups based on their priority class. The first
-command gets all the processes on the computer and then stores them in the `$A` variable.
+These commands display processes on the computer in groups based on their
+[priority class](/dotnet/api/system.diagnostics.processpriorityclass). The first command gets all
+processes on the computer and stores them in the `$processes` variable.
 
-The second command pipes the **Process** object stored in the `$A` variable to the `Get-Process`
-cmdlet, then to the `Format-Table` cmdlet, which formats the processes by using the **Priority**
-view.
-
-The **Priority** view, and other views, are defined in the PS1XML format files in the PowerShell
-home directory (`$PSHOME`).
+The second command pipes the **Process** objects stored in the `$processes` variable to the
+`Sort-Object` cmdlet, then to the `Format-Table` cmdlet, which formats the processes using the
+**Priority** view.
 
 ### Example 5: Add a property to the standard Get-Process output display
 

reference/7.6/Microsoft.PowerShell.Management/Get-Process.md

@@ -110,22 +110,20 @@ objects to the `Where-Object` cmdlet, which selects only the object with a value
 `Get-Process | Get-Member`. By default, the values of all amount properties are in bytes, even
 though the default display lists them in kilobytes and megabytes.
 
-### Example 4: List processes on the computer in groups based on priority
+### Example 4: Display processes on the computer in groups based on priority
 
 ```powershell
-$A = Get-Process
-$A | Get-Process | Format-Table -View Priority
+$processes = Get-Process
+$processes | Sort-Object { $_.PriorityClass } | Format-Table -View Priority
 ```
 
-These commands list the processes on the computer in groups based on their priority class. The first
-command gets all the processes on the computer and then stores them in the `$A` variable.
+These commands display processes on the computer in groups based on their
+[priority class](/dotnet/api/system.diagnostics.processpriorityclass). The first command gets all
+processes on the computer and stores them in the `$processes` variable.
 
-The second command pipes the **Process** object stored in the `$A` variable to the `Get-Process`
-cmdlet, then to the `Format-Table` cmdlet, which formats the processes by using the **Priority**
-view.
-
-The **Priority** view, and other views, are defined in the PS1XML format files in the PowerShell
-home directory (`$PSHOME`).
+The second command pipes the **Process** objects stored in the `$processes` variable to the
+`Sort-Object` cmdlet, then to the `Format-Table` cmdlet, which formats the processes using the
+**Priority** view.
 
 ### Example 5: Add a property to the standard Get-Process output display