covers #295

	name: Update Documentation

	on:
	push:
	branches: ["main"]

	workflow_dispatch:

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

	concurrency:
	group: "pages"
	cancel-in-progress: true

	env:
	LANG: "en_US.UTF-8"
	LANGUAGE: "en_US.UTF-8"
	LC_ALL: "en_US.UTF-8"
	SCHEME: "iOSAccessibilityHandbook"
	SCHEME_LOWERCASED: "iosaccessibilityhandbook"
	XCODE_VERSION: '~>15'
	DERIVED_DATA_PATH: './DerivedData/'
	DESTINATION: 'generic/platform=iOS'
	REPOSITORY_NAME: 'AccessibilityDocumentation'
	ARTEFACT_PATH: '../docs'

	jobs:
	update-docs:
	runs-on: 'macos-13'
	steps:
	- uses: maxim-lobanov/setup-xcode@v1
	with:
	xcode-version: latest

	- name: Checkout
	uses: actions/checkout@v3

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

	- name: Compile
	run: >
	xcodebuild docbuild -scheme ${{ env.SCHEME }}
	-destination 'generic/platform=iOS'
	-derivedDataPath ${{ env.DERIVED_DATA_PATH }}

	- name: Make Static Site
	run: >
	$(xcrun --find docc) process-archive
	transform-for-static-hosting ${{ env.DERIVED_DATA_PATH }}Build/Products/Debug-iphoneos/${{ env.SCHEME }}.doccarchive
	--output-path ${{ env.ARTEFACT_PATH }}
	--hosting-base-path ${{ env.REPOSITORY_NAME }}

	- name: Upload artifact
	uses: actions/upload-pages-artifact@v1
	with:
	path: ${{ env.ARTEFACT_PATH }}

	deploy:
	needs: update-docs

	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}documentation/${{ env.SCHEME_LOWERCASED }}/

	runs-on: 'macos-13'
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v1

Provide feedback