Fix table to refer to existing md files, add col for Configurable (#988)

* Fix table to refer to existing md files, add col for Configurable

* Remove deprecated rules, rename to match actual rule sans PS prefix

* Add Pester tests for rule doc files, add back UseSingularNouns.md file

* Add Pester tests for verifying rule doc README.md file

* fix typo in documentation folder, remove redundant ipmo call new tests in CI and add to docs

* Add rules that will be present in 1.17 and fix typo in md file name

* remove redundant import of PSScriptAnalyzerTestHelper test helper module in documentation test

* Fix doc tests for PS v4 and PS Core

This commit removes rules that aren't available on these versions

* Remove leftovers from deprecated rules AvoidUsingFilePath, AvoidUninitializedVariable and AvoidTrapStatement in code and documentation.
Fix markdown in PowerShellBestPractices.md and tidy up

* added remarks about rules not being available in certain powershell versions

* Add superscript/footnote on rules not available everywhere

* Update test to strip off the optional superscript markdown

Author: rkeithhill

Engine/Settings/PSGallery.psd1

@@ -21,7 +21,6 @@
                    'PSAvoidUsingConvertToSecureStringWithPlainText',
                    'PSUsePSCredentialType',
                    'PSAvoidUsingUserNameAndPasswordParams',
-                   'PSAvoidUsingFilePath',
                    'PSDSC*'
                    )
 }

Engine/Settings/ScriptSecurity.psd1

@@ -3,6 +3,5 @@
                    'PSAvoidUsingComputerNameHardcoded',
                    'PSAvoidUsingConvertToSecureStringWithPlainText',
                    'PSUsePSCredentialType',
-                   'PSAvoidUsingUserNameAndPasswordParams',
-                   'PSAvoidUsingFilePath')
+                   'PSAvoidUsingUserNameAndPasswordParams')
 }

PowerShellBestPractices.md

@@ -158,16 +158,10 @@ Pester-based ScriptAnalyzer Tests are located in `path/to/PSScriptAnalyzer/Tests
 
 * Ensure [Pester 4.3.1](https://www.powershellgallery.com/packages/Pester/4.3.1) is installed
 * Copy `path/to/PSScriptAnalyzer/out/PSScriptAnalyzer` to a folder in `PSModulePath`
-* Go the Tests folder in your local repository
-* Run Engine Tests:
+* In the root folder of your local repository, run:
 ``` PowerShell
-cd /path/to/PSScriptAnalyzer/Tests/Engine
-Invoke-Pester
-```
-* Run Tests for Built-in rules:
-``` PowerShell
-cd /path/to/PSScriptAnalyzer/Tests/Rules
-Invoke-Pester
+$testScripts = ".\Tests\Engine",".\Tests\Rules",".\Tests\Documentation"
+Invoke-Pester -Script $testScripts
 ```
 
 [Back to ToC](#table-of-contents)

README.md

@@ -4,11 +4,12 @@
 
 ## Description
 
-Globally scoped aliases override existing aliases within the sessions with matching names. This name collision can cause difficult to debug issues for consumers of modules and scripts.  
-
+Globally scoped aliases override existing aliases within the sessions with matching names. This name collision can cause difficult to debug issues for consumers of modules and scripts.
 
 To understand more about scoping, see ```Get-Help about_Scopes```.
 
+**NOTE** This rule is not available in PowerShell version 3 and 4 due to the `StaticParameterBinder.BindCommand` API that the rule uses internally.
+
 ## How
 
 Use other scope modifiers for new aliases.