mod #4

	name: Build and Deploy Hub Documentation

	on:
	push:
	branches: [ main ]
	pull_request:
	branches: [ main ]

	permissions:
	contents: write
	pages: write
	id-token: write
	pull-requests: write

	jobs:
	build:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4

	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: '3.10'

	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install pyyaml

	- name: Generate documentation site
	run: \|
	python scripts/generate_site.py . docs

	- name: Upload artifact
	uses: actions/upload-artifact@v4
	with:
	name: hub-site
	path: docs/

	- name: Deploy to GitHub Pages
	if: github.event_name == 'push' && github.ref == 'refs/heads/main'
	uses: peaceiris/actions-gh-pages@v4
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./docs

	- name: Comment on PR
	if: github.event_name == 'pull_request'
	uses: actions/github-script@v6
	with:
	script: \|
	github.rest.issues.createComment({
	issue_number: context.issue.number,
	owner: context.repo.owner,
	repo: context.repo.repo,
	body: '✅ Hub documentation generated! View the preview in the artifact or at the GitHub Pages link once merged.'
	})

Provide feedback