Feature 534495: Documentation Generation (GH Pages) #1

	name: Test Documentation Generation

	on:
	workflow_dispatch:
	inputs:
	branch_type:
	description: 'Type of branch to simulate'
	required: true
	default: 'main'
	type: choice
	options:
	- main
	- release/v1
	- release/v2
	pull_request:
	branches:
	- main

	permissions:
	contents: read
	pages: write
	id-token: write

	jobs:
	test-docs-generation:
	runs-on: ubuntu-latest
	environment:
	name: github-pages-test
	url: ${{ steps.deployment.outputs.page_url }}

	steps:
	- name: Check out code
	uses: actions/checkout@v4

	- name: Setup Node.js
	uses: actions/setup-node@v4
	with:
	node-version-file: .nvmrc

	- name: Install dependencies
	run: npm ci

	- name: Set branch type based on trigger
	id: set-branch
	run: \|
	if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
	echo "BRANCH_TYPE=${{ github.event.inputs.branch_type }}" >> $GITHUB_ENV
	else
	echo "BRANCH_TYPE=main" >> $GITHUB_ENV
	fi
	echo "VERSION=1.2.3" >> $GITHUB_ENV

	- name: Generate documentation
	run: \|
	mkdir -p .github/scripts/docs
	bash .github/scripts/docs/generate-and-publish-docs.sh "$BRANCH_TYPE" "$VERSION"

	# Move to Jekyll expected structure
	mkdir -p _site
	cp -r docs-site/* _site/

	# Create .nojekyll file to bypass Jekyll processing
	touch _site/.nojekyll

	- name: Setup Pages
	uses: actions/configure-pages@v5

	- name: Upload artifact
	uses: actions/upload-pages-artifact@v3
	with:
	path: '_site'

	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback