Add pester-docs workflow example to contributing page

Tests/Integration/CrossVersionCodeExamples/README.md

@@ -2,7 +2,7 @@
 
 This test assures:
 
-- That all `Get-Help` examples render identically on **all** PowerShell versions
+- That various `Get-Help` examples render identically on **all** PowerShell versions
 
 Additional information:
 

Tests/Integration/PlaceholderExamples/README.md

@@ -3,4 +3,4 @@
 This test ensures:
 
 - That the PlatyPS-generated placeholder examples render as expected on all platforms
-- That using the `-NoPlaceHolderExamples` switch results in an empty `EXAMPLES` section
+- That using the `-NoPlaceHolderExamples` switch results in an empty `.EXAMPLES` Get-Help section

Tests/Integration/SeparateMarkdownHeadings/README.md

@@ -1,9 +1,9 @@
 # SeparateMarkdownHeadings
 
-This test ensures:
+This test ensures that this function:
 
-- That only valid markdown headings (with no blank line beneath them) are processed
-- That a blank line is inserted beneath the heading if needed
+- Only matches valid markdown headings (and thus with no blank line beneath them)
+- Inserts a blank line beneath those heading matches
 
 Additional information:
 

website/docs/contributing.mdx

@@ -3,8 +3,14 @@ id: contributing
 title: Contributing
 ---
 
-This module is compiled using the source files found in this
-[Source folder](https://github.com/alt3/Docusaurus.PowerShell/tree/main/Source).
+This module is compiled using source files found in this
+[Source](https://github.com/alt3/Docusaurus.PowerShell/tree/main/Source)
+folder.
+
+## Pull Requests
+
+When providing pull requests, please make sure to include an appropriate
+[Pester test](https://github.com/alt3/Docusaurus.PowerShell/tree/main/Tests).
 
 ## Installation
 
@@ -40,7 +46,21 @@ Supports the Pester `-Output` parameter for more testing details.
 
 :::
 
-## Test Cases
+## Example
+
+Imagine developing the Alt3-module and testing it against the
+[Pester documentation website](https://pester.dev/) to see the effect
+of your code changes.
+
+The below steps would:
 
-Please make sure to include an [appropriate Pester test](https://github.com/alt3/Docusaurus.PowerShell/tree/main/Tests)
-when providing code changes.
+1. Build a fresh version of the Alt3-module containing your code changes
+2. Import your version of the Alt3-module into your current session
+3. Use your in-session Alt3-module to generate the Pester Docusaurus command pages
+
+```
+cd Alt3.Docusaurus.Powershell
+.\build-module.ps1
+cd ..\pester-docs\
+.\generate-command-reference.ps1 -SkipModuleImport
+```