Repository navigation

refactor: move the user guide into its own module and fix its navbar link #1814

	name: CI Tests

	on:
	push:
	branches:
	- main
	pull_request:
	branches:
	- main
	release:
	types: [published]

	jobs:
	build:
	runs-on: ubuntu-latest
	strategy:
	matrix:
	python-version: ["3.11", "3.12", "3.13", "3.14"]
	fail-fast: false

	steps:
	- uses: actions/checkout@v6

	- name: Set up Python ${{ matrix.python-version }}
	uses: actions/setup-python@v6
	with:
	python-version: ${{ matrix.python-version }}

	- name: Set up Go
	uses: actions/setup-go@v5
	with:
	go-version: "stable"
	cache: false

	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install -e ".[dev]"

	- name: Install d2 (for the diagram-rendering integration test)
	run: \|
	curl -fsSL https://d2lang.com/install.sh \| sh -s -- --version v0.8.2
	echo "$HOME/.local/bin" >> "$GITHUB_PATH"
	"$HOME/.local/bin/d2" --version

	- name: Run tests
	run: \|
	make test

	- name: Test CLI
	run: \|
	great-docs --help
	great-docs --version

	release-pypi:
	name: "Release to PyPI"
	runs-on: ubuntu-latest
	if: github.event_name == 'release'
	needs: build
	steps:
	- uses: actions/checkout@v6

	- uses: actions/setup-python@v6
	with:
	python-version: "3.13"

	- name: "Build Package"
	run: \|
	python -m pip install build wheel
	python -m build --sdist --wheel

	- name: "Deploy to PyPI"
	uses: pypa/gh-action-pypi-publish@release/v1
	with:
	user: __token__
	password: ${{ secrets.PYPI_API_TOKEN }}