Docs

Added September 2023 baselines #2451 (#2452) #379

	#
	# Build documentation site
	#

	# NOTES:
	# This workflow generates and published the documentation site https://azure.github.io/PSRule.Rules.Azure/.

	name: Docs
	on:
	push:
	branches:
	- main
	workflow_dispatch:

	permissions: {}

	env:
	DOTNET_NOLOGO: true
	DOTNET_CLI_TELEMETRY_OPTOUT: true

	jobs:
	deploy:
	name: Publish docs
	runs-on: ubuntu-latest
	permissions:
	contents: write
	steps:

	- name: Checkout
	uses: actions/checkout@v4
	with:
	fetch-depth: 0

	- name: Configure
	run: \|
	git config user.name github-actions
	git config user.email '41898282+github-actions[bot]@users.noreply.github.com'

	- name: Setup Python
	uses: actions/setup-python@v4
	with:
	python-version: '3.11'
	architecture: x64

	- name: Install dependencies
	run: \|
	python3 -m pip install --upgrade pip
	python3 -m pip install wheel
	python3 -m pip install -r requirements-docs.txt

	- name: Build docs
	run: \|
	Install-Module InvokeBuild -MinimumVersion 5.4.0 -Scope CurrentUser -Force
	Invoke-Build BuildDocs
	shell: pwsh

	- name: Build site
	run: mkdocs build

	- name: Deploy
	uses: peaceiris/actions-gh-pages@v3
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./site

Provide feedback