Allow site builds without publication

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/actions/Get-PSModuleSettings/src/Settings.schema.json

@@ -196,6 +196,16 @@
               "description": "The type of release to create: Release (stable), Prerelease, or None."
             }
           }
+        },
+        "Site": {
+          "type": "object",
+          "description": "Documentation site publish configuration",
+          "properties": {
+            "Skip": {
+              "type": "boolean",
+              "description": "Skip publishing the generated documentation site"
+            }
+          }
         }
       }
     },

.github/actions/Get-PSModuleSettings/src/main.ps1

@@ -203,6 +203,9 @@ $settings = [pscustomobject]@{
             UsePRBodyAsReleaseNotes  = $settings.Publish.Module.UsePRBodyAsReleaseNotes ?? $true
             UsePRTitleAsNotesHeading = $settings.Publish.Module.UsePRTitleAsNotesHeading ?? $true
         }
+        Site   = [pscustomobject]@{
+            Skip = $settings.Publish.Site.Skip ?? $false
+        }
     }
     Linter                = [pscustomobject]@{
         Skip                 = $settings.Linter.Skip ?? $false
@@ -688,10 +691,10 @@ LogGroup 'Calculate Job Run Conditions:' {
 
     $settings.Publish.Module | Add-Member -MemberType NoteProperty -Name Desired -Value (($releaseType -ne 'None') -or $shouldAutoCleanup) -Force
     $settings.Publish.Module | Add-Member -MemberType NoteProperty -Name Enabled -Value (($releaseType -ne 'None') -or $shouldAutoCleanup) -Force
-    $settings.Publish | Add-Member -MemberType NoteProperty -Name Site -Value ([pscustomobject]@{
-            Desired = $releaseType -eq 'Release'
-            Enabled = $releaseType -eq 'Release'
-        }) -Force
+    $settings.Publish.Site | Add-Member -MemberType NoteProperty -Name Desired -Value ($releaseType -eq 'Release') -Force
+    $settings.Publish.Site | Add-Member -MemberType NoteProperty -Name Enabled -Value (
+        $releaseType -eq 'Release' -and -not $settings.Publish.Site.Skip
+    ) -Force
 
     $settings | Add-Member -MemberType NoteProperty -Name HasImportantChanges -Value $hasImportantChanges
 

docs/content/reference/settings.md

@@ -58,6 +58,7 @@ For worked examples, see [Configuring the pipeline](../guides/configuring-the-pi
 | `Build.Docs.Skip`                         | `Boolean` | Skip documentation build                                                                                                                                             | `false`             |
 | `Build.Docs.ShowSummaryOnSuccess`         | `Boolean` | Show super-linter summary on success for documentation linting                                                                                                       | `false`             |
 | `Build.Site.Skip`                         | `Boolean` | Skip site build                                                                                                                                                      | `false`             |
+| `Publish.Site.Skip`                       | `Boolean` | Skip publishing the generated documentation site                                                                                                                     | `false`             |
 | `Publish.Module.Skip`                     | `Boolean` | Skip module publishing                                                                                                                                               | `false`             |
 | `Publish.Module.AutoCleanup`              | `Boolean` | Automatically clean up old prerelease tags when merging to main or when a PR is abandoned                                                                            | `true`              |
 | `Publish.Module.AutoPatching`             | `Boolean` | Automatically patch module version                                                                                                                                   | `true`              |
@@ -137,6 +138,8 @@ Test:
     StepSummaryMode: 'Missed, Files'
 
 Publish:
+  Site:
+    Skip: false
   Module:
     Skip: false
     AutoCleanup: true

tests/srcTestRepo/.github/PSModule.yml

@@ -1,5 +1,5 @@
 Name: PSModuleTest2
-Build:
+Publish:
   Site:
     Skip: true
 Linter:

tests/srcWithManifestTestRepo/.github/PSModule.yml

@@ -1,7 +1,9 @@
 Name: PSModuleTest
-Build:
+Publish:
   Site:
     Skip: true
+  Module:
+    AutoCleanup: false
 Test:
   SourceCode:
     Skip: true
@@ -12,9 +14,6 @@ Test:
     Skip: false
   CodeCoverage:
     PercentTarget: 1
-Publish:
-  Module:
-    AutoCleanup: false
 Linter:
   env:
     VALIDATE_BIOME_FORMAT: false