feat: add initial documentation website #17

	name: "Release Docs"

	on:
	workflow_dispatch:
	pull_request:
	branches:
	- main
	paths:
	- 'mkdocs/**'
	- 'src/**'

	concurrency:
	group: ${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: ${{ github.event_name == 'pull_request' }}

	permissions:
	contents: write

	jobs:
	docs:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v5
	with:
	fetch-depth: 0

	- uses: actions/setup-python@v6
	with:
	python-version: '3.11'

	- name: Install dependencies
	run: \|
	sudo apt-get update
	sudo apt-get install -y doxygen
	make install-deps

	- name: Build API documentation with Doxygen
	run: make build-api-docs

	- name: Build docs
	run: make build-docs

	- name: Deploy to gh-pages
	if: github.event_name == 'pull_request'
	run: \|
	git config --global user.name 'GitHub Actions'
	git config --global user.email '[email protected]'

	git checkout --orphan gh-pages-tmp
	git rm --quiet -rf .
	cp -r ./mkdocs/site/* .
	echo "cpp.iceberg.apache.org" > CNAME
	git add --all
	git commit -m "Publish docs from commit ${{ github.sha }}"
	git push -f origin gh-pages-tmp:gh-pages

Provide feedback