feat(dx): add docusaurus v3 documentation site with github pages ci/cd #1

	name: Deploy Docs to GitHub Pages

	on:
	push:
	branches:
	- main
	paths:
	- 'docs/**'
	- '.github/workflows/docs.yml'
	pull_request:
	paths:
	- 'docs/**'
	- '.github/workflows/docs.yml'
	workflow_dispatch:

	permissions:
	contents: write

	jobs:
	build:
	runs-on: ubuntu-latest
	defaults:
	run:
	working-directory: docs

	steps:
	- name: Checkout
	uses: actions/checkout@v4

	- name: Setup Node.js
	uses: actions/setup-node@v4
	with:
	node-version: 22
	cache: npm
	cache-dependency-path: docs/package-lock.json

	- name: Install dependencies
	run: npm ci

	- name: Build Docusaurus site
	run: npm run build

	deploy:
	needs: build
	if: github.ref == 'refs/heads/main' && github.event_name == 'push'
	runs-on: ubuntu-latest
	defaults:
	run:
	working-directory: docs

	steps:
	- name: Checkout
	uses: actions/checkout@v4

	- name: Setup Node.js
	uses: actions/setup-node@v4
	with:
	node-version: 22
	cache: npm
	cache-dependency-path: docs/package-lock.json

	- name: Install dependencies
	run: npm ci

	- name: Build Docusaurus site
	run: npm run build

	- name: Deploy to GitHub Pages
	uses: peaceiris/actions-gh-pages@v4
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: docs/build
	publish_branch: gh-pages
	user_name: 'github-actions[bot]'
	user_email: 'github-actions[bot]@users.noreply.github.com'

Provide feedback