DOC bring back numbering for user guide, raise build issues as errors, and fix warnings #62

	name: build-book

	on:
	push:
	branches:
	- "main"
	pull_request:
	branches:
	- "main"
	- "release/**"
	workflow_dispatch:

	# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
	permissions:
	contents: read
	pages: write
	id-token: write

	# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
	# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
	concurrency:
	group: "pages"
	cancel-in-progress: false

	# This job installs dependencies, builds the book, and pushes it to `gh-pages`
	jobs:
	deploy-book:
	runs-on: ubuntu-latest
	permissions:
	pages: write
	id-token: write
	steps:
	- uses: actions/checkout@v4

	# Install dependencies
	- name: Set up Python 3.11
	uses: actions/setup-python@v5
	with:
	python-version: 3.11

	- name: Install PyRIT with pip
	run: pip install .[dev]
	# Build the book
	- name: Build the book
	run: \|
	make docs-build
	# Upload the book's HTML as an artifact
	- name: Upload artifact
	uses: actions/upload-pages-artifact@v3
	with:
	path: "doc/_build/html"
	- name: Deploy to GitHub Pages
	if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback