docs: sanitize examples (#258)

- Updated `Request-SddcManagerBackupStatus.md` doc to sanitize all the example variables, add brackets and punctuation.
- Updated `Request-SddcManagerFreePool.md` doc to sanitize all the example variables, add brackets and punctuation.
- Updated `Request-SddcManagerSnapshotStatus.md` doc to sanitize all the example variables, add brackets and punctuation.
- Updated `Request-SddcManagerStorageHealth.md` doc to sanitize all the example variables, add brackets and punctuation.
- Updated `Request-SoSHealthJson.md` doc to sanitize all the example variables, add brackets and punctuation.

Signed-off-by: Andy Beltz <andy.beltz@broadcom.com>

Author: andybeltz

docs/documentation/functions/Request-SddcManagerBackupStatus.md

@@ -15,23 +15,23 @@ Request-SddcManagerBackupStatus [-server] <String> [-user] <String> [-pass] <Str
 The `Request-SddcManagerBackupStatus` cmdlet returns the status of the latest file-level backup task in an SDDC Manager instance.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates network connectivity and authentication to the SDDC Manager instance
-- Collects the latest file-level backup status details
+- Validates network connectivity and authentication to the SDDC Manager instance.
+- Collects the latest file-level backup status details.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-SddcManagerBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
+Request-SddcManagerBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
 ```
 
 This example will return the status of the latest file-level backup task in an SDDC Manager instance.
 
 ### Example 2
 
 ```powershell
-Request-SddcManagerBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -failureOnly
+Request-SddcManagerBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -failureOnly
 ```
 
 This example will return the status of the latest file-level backup task in an SDDC Manager instance but only reports issues.

docs/documentation/functions/Request-SddcManagerFreePool.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Returns the status of the ESXi hosts in the free pool.
+Returns the status of the ESX hosts in the free pool managed by SDDC Manager..
 
 ## Syntax
 
@@ -12,29 +12,29 @@ Request-SddcManagerFreePool [-server] <String> [-user] <String> [-pass] <String>
 
 ## Description
 
-The `Request-SddcManagerFreePool` cmdlet returns status of the ESXi hosts in the free pool.
+The `Request-SddcManagerFreePool` cmdlet returns status of the ESX hosts in the free pool managed by SDDC Manager.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates that network connectivity and authentication is possible to the SDDC Manager instance
-- Gathers the details for the ESXi hosts in the free pool
+- Validates that network connectivity and authentication is possible to the SDDC Manager instance.
+- Gathers the details for the ESX hosts in the free pool.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-SddcManagerFreePool -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
+Request-SddcManagerFreePool -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
 ```
 
-This example will return the ESXi hosts in the free pool managed by SDDC Manager for a workload domain.
+This example will return the ESX hosts in the free pool managed by SDDC Manager.
 
 ### Example 2
 
 ```powershell
-Request-SddcManagerFreePool -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -failureOnly
+Request-SddcManagerFreePool -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -failureOnly
 ```
 
-This example will return the ESXi hosts in the free pool managed by SDDC Manager for a workload domain but only reports issues.
+This example will return the ESX hosts in the free pool managed by SDDC Manager for a workload domain but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-SddcManagerSnapshotStatus.md

@@ -15,28 +15,28 @@ Request-SddcManagerSnapshotStatus [-server] <String> [-user] <String> [-pass] <S
 The `Request-SddcManagerSnapshotStatus` cmdlet checks the snapshot status for SDDC Manager.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates network connectivity and authenticaton to the SDDC Manager instance
-- Gathers the details for the vCenter Server instance from the SDDC Manager
-- Validates network connectivity and authentication to the vCenter Server instance
-- Performs checks on the snapshot status and outputs the results
+- Validates network connectivity and authenticaton to the SDDC Manager instance.
+- Gathers the details for the vCenter instance from the SDDC Manager.
+- Validates network connectivity and authentication to the vCenter instance.
+- Performs checks on the snapshot status and outputs the results.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-SddcManagerSnapshotStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
+Request-SddcManagerSnapshotStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
 ```
 
 This example will publish the snapshot status for the SDDC Manager in a VMware Cloud Foundation instance.
 
 ### Example 2
 
 ```powershell
-Request-SddcManagerSnapshotStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -failureOnly
+Request-SddcManagerSnapshotStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -failureOnly
 ```
 
-This example will publish the snapshot status for the SDDC Manager in a VMware Cloud Foundation instance, but for only failed items.
+This example will publish the snapshot status for the SDDC Manager in a VMware Cloud Foundation instance but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-SddcManagerStorageHealth.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Checks the storage health (capacity) in an SDDC Manager appliance.
+Checks the storage health capacity in an SDDC Manager appliance.
 
 ## Syntax
 
@@ -12,28 +12,28 @@ Request-SddcManagerStorageHealth [-server] <String> [-user] <String> [-pass] <St
 
 ## Description
 
-The `Request-SddcManagerStorageHealth` cmdlet checks the disk free space on the SDDC Manager appliance.
+The `Request-SddcManagerStorageHealth` cmdlet checks the hard disk space in an SDDC Manager appliance.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, -`pass`, `-localUser`, and `-localPass` values:
 
-- Performs checks on the local storage used space and outputs the results
+- Performs checks on the local storage used space in an SDDC Manager appliance and outputs the results.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-SddcManagerStorageHealth -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -localUser vcf -localPass VMw@re1!
+Request-SddcManagerStorageHealth -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -localUser [local_username] -localPass [local_password]
 ```
 
-This example checks the hard disk space in the SDDC Manager appliance.
+This example checks the hard disk space in an SDDC Manager appliance.
 
 ### Example 2
 
 ```powershell
-Request-SddcManagerStorageHealth -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -localUser vcf -localPass VMw@re1! -failureOnly
+Request-SddcManagerStorageHealth -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -localUser [local_username] -localPass [local_password] -failureOnly
 ```
 
-This example checks the hard disk space in the SDDC Manager appliance and outputs only the failures.
+This example checks the hard disk space in the SDDC Manager but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-SoSHealthJson.md

@@ -2,43 +2,43 @@
 
 ## Synopsis
 
-Run SoS and save the JSON output.
+Run SOS and save the JSON output.
 
 ## Syntax
 
 ### All-WorkloadDomains
 
 ```powershell
-Request-SoSHealthJson -server <String> -user <String> -pass <String> -reportPath <String> [-allDomains] [<CommonParameters>]
+Request-SoSHealthJson [-server] <String> [-user] <String> [-pass] <String> [-reportPath] <String> [-allDomains] [<CommonParameters>]
 ```
 
 ### Specific-WorkloadDomain
 
 ```powershell
-Request-SoSHealthJson -server <String> -user <String> -pass <String> -reportPath <String> -workloadDomain <String> [<CommonParameters>]
+Request-SoSHealthJson [-server] <String> [-user] <String> [-pass] <String> [-reportPath] <String> [-workloadDomain] <String> [<CommonParameters>]
 ```
 
 ## Description
 
-The `Request-SoSHealthJson` cmdlet connects to SDDC Manager, runs an SoS Health collection to JSON, and saves the JSON file to the local file system.
+The `Request-SoSHealthJson` cmdlet connects to SDDC Manager, runs an SOS health collection and saves to a JSON file on the local file system.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-SoSHealthJson -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -reportPath F:\Reporting\HealthReports -allDomains
+Request-SoSHealthJson -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -reportPath [report_path] -allDomains
 ```
 
-This example runs an SoS Health collection for all domains in the SDDC and saves the JSON output to the local file system.
+This example runs an SOS health collection for all domains in the SDDC and saves the JSON file on the local file system in the specified report path.
 
 ### Example 2
 
 ```powershell
-Request-SoSHealthJson -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -reportPath F:\Reporting\HealthReports -workloadDomain sfo-w01
+Request-SoSHealthJson -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -reportPath [report_path] -workloadDomain [workload_domain_name]
 ```
 
-This example runs an SoS Health collection for a workload domain in the SDDC and saves the JSON output to the local file system.
+This example runs an SOS health collection for a specified workload domain in the SDDC and saves the JSON file on the local file system in the specified report path.
 
 ## Parameters