Initial editorial suggestions from T. Taft #2032

	name: Sphinx Content Tests

	on: [push, pull_request]

	defaults:
	run:
	working-directory: frontend

	jobs:
	sphinx-content:

	runs-on: ubuntu-22.04

	strategy:
	matrix:
	python-version: ['3.11']
	node-version: [20.x]

	steps:
	- uses: actions/checkout@v4
	- name: Set up Python ${{ matrix.python-version }}
	uses: actions/setup-python@v5
	with:
	python-version: ${{ matrix.python-version }}
	- uses: actions/checkout@v4
	- name: Enable Corepack
	run: corepack enable
	- name: Use Node.js ${{ matrix.node-version }}
	uses: actions/setup-node@v4
	with:
	node-version: ${{ matrix.node-version }}
	cache: 'yarn'
	cache-dependency-path: 'frontend'
	- name: Install OS Deps
	run: \|
	sudo apt-get update
	sudo apt-get install -y \
	crudini \
	graphviz \
	plantuml
	- name: Install GNAT FSF
	run: \|
	${GITHUB_WORKSPACE}/.github/workflows/install_toolchain.sh --gnat
	- name: Increase max user watches
	run: \|
	echo fs.inotify.max_user_watches=524288 \| sudo tee -a /etc/sysctl.conf && \
	sudo sysctl -p
	- name: Install dependencies
	run: yarn --immutable
	- name: Install Python dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install -r requirements_frozen.txt
	- name: Run SPHINX engine tests
	run: make SPHINXOPTS="-W" test_engine
	- name: Build HTML content
	run: make HIDDEN_BOOKS="" HIDDEN_CONTENTS="" cleanall webpack-production sphinx-production
	- name: Archive HTML content in artifact
	uses: actions/upload-artifact@v4
	with:
	name: learn-html
	path: \|
	frontend/dist/html
	if-no-files-found: error
	retention-days: 1
	compression-level: 9

Provide feedback