Update rule docs for removed API rules (#43)

BernieWhite · web-flow · commit bc8248c6b8bd · 2020-02-18T13:22:22.000+10:00
diff --git a/RuleToc.Doc.ps1 b/RuleToc.Doc.ps1
@@ -5,7 +5,7 @@ Document 'module' {
     Title 'Module rule reference'
 
     Import-Module .\out\modules\PSRule.Rules.Kubernetes
-    $rules = Get-PSRule -Module PSRule.Rules.Kubernetes -WarningAction SilentlyContinue |
+    $rules = Get-PSRule -Module PSRule.Rules.Kubernetes -WarningAction SilentlyContinue -Baseline AKS |
         Add-Member -MemberType ScriptProperty -Name Category -Value { $this.Info.Annotations.category } -PassThru |
         Sort-Object -Property Category;
 
diff --git a/docs/rules/en/module.md b/docs/rules/en/module.md
@@ -8,7 +8,9 @@ The following rules are included within `PSRule.Rules.Kubernetes`.
 
 Name | Synopsis | Severity
 ---- | -------- | --------
-[Kubernetes.API.Removal](Kubernetes.API.Removal.md) | Avoid using legacy API endpoints. | Important
+[Kubernetes.API.v1.16](Kubernetes.API.v1.16.md) | Avoid using legacy API endpoints not served by Kubernetes v1.16. | Important
+[Kubernetes.API.v1.17](Kubernetes.API.v1.17.md) | Avoid using legacy API endpoints not served by Kubernetes v1.17. | Important
+[Kubernetes.API.v1.20](Kubernetes.API.v1.20.md) | Avoid using legacy API endpoints not served by Kubernetes v1.20. | Important
 
 ### Management
 
diff --git a/pipeline.build.ps1 b/pipeline.build.ps1
@@ -275,7 +275,7 @@ task Analyze Build, PSScriptAnalyzer, {
 # Synopsis: Build table of content for rules
 task BuildRuleDocs Build, PSRule, PSDocs, {
     Import-Module (Join-Path -Path $PWD -ChildPath out/modules/PSRule.Rules.Kubernetes) -Force;
-    $Null = Invoke-PSDocument -Name module -OutputPath .\docs\rules\en-US\ -Path .\RuleToc.Doc.ps1;
+    $Null = Invoke-PSDocument -Name module -OutputPath .\docs\rules\en\ -Path .\RuleToc.Doc.ps1;
 }
 
 # Synopsis: Build help
@@ -290,7 +290,7 @@ task BuildHelp BuildModule, PlatyPS, {
 
 task ScaffoldHelp Build, BuildRuleDocs, {
     # Import-Module (Join-Path -Path $PWD -ChildPath out/modules/PSRule.Rules.Kubernetes) -Force;
-    # Update-MarkdownHelp -Path '.\docs\commands\PSRule.Rules.Kubernetes\en-US';
+    # Update-MarkdownHelp -Path '.\docs\commands\PSRule.Rules.Kubernetes\en';
 }
 
 # Synopsis: Add shipit build tag

Original file line number	Diff line number	Diff line change
`@@ -275,7 +275,7 @@ task Analyze Build, PSScriptAnalyzer, {`
`275`	`275`	`# Synopsis: Build table of content for rules`
`276`	`276`	`task BuildRuleDocs Build, PSRule, PSDocs, {`
`277`	`277`	`Import-Module (Join-Path -Path $PWD -ChildPath out/modules/PSRule.Rules.Kubernetes) -Force;`
`278`		`- $Null = Invoke-PSDocument -Name module -OutputPath .\docs\rules\en-US\ -Path .\RuleToc.Doc.ps1;`
	`278`	`+ $Null = Invoke-PSDocument -Name module -OutputPath .\docs\rules\en\ -Path .\RuleToc.Doc.ps1;`
`279`	`279`	`}`
`280`	`280`
`281`	`281`	`# Synopsis: Build help`
`@@ -290,7 +290,7 @@ task BuildHelp BuildModule, PlatyPS, {`
`290`	`290`
`291`	`291`	`task ScaffoldHelp Build, BuildRuleDocs, {`
`292`	`292`	`# Import-Module (Join-Path -Path $PWD -ChildPath out/modules/PSRule.Rules.Kubernetes) -Force;`
`293`		`- # Update-MarkdownHelp -Path '.\docs\commands\PSRule.Rules.Kubernetes\en-US';`
	`293`	`+ # Update-MarkdownHelp -Path '.\docs\commands\PSRule.Rules.Kubernetes\en';`
`294`	`294`	`}`
`295`	`295`
`296`	`296`	`# Synopsis: Add shipit build tag`