[Backport release_3.40] Clarify settings to use in matrix distance dialog #5773

	name: Docs builds

	concurrency:
	group: ${{ github.workflow }}-${{ github.event.pull_request.number \|\| github.ref }}
	cancel-in-progress: true

	on:
	push:
	paths-ignore:
	- 'locale/**'

	pull_request:
	paths-ignore:
	- 'locale/**'

	permissions: # added using https://github.com/step-security/secure-repo
	contents: read

	jobs:
	build:

	runs-on: ubuntu-latest
	strategy:
	matrix:
	format: [html, pdf]

	steps:
	- name: Harden Runner
	uses: step-security/harden-runner@91182cccc01eb5e619899d80e4e971d6181294a7 # v2.10.1
	with:
	egress-policy: audit # TODO: change to 'egress-policy: block' after couple of runs

	- name: Check out repository
	uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
	with:
	fetch-depth: 1
	- name: Set up Python 3.12
	uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0
	with:
	python-version: '3.12'
	- name: Install Requirements
	run: \|
	if [[ ${{ matrix.format }} != "html" ]]; then
	sudo apt-get update && sudo apt-get install -y texlive-xetex fonts-freefont-otf
	fi

	python -m pip install --upgrade pip
	pip install -r REQUIREMENTS.txt

	- name: Build English ${{ matrix.format }} documentation
	run: \|
	make ${{ matrix.format }}
	- name: Upload ${{ matrix.format }} build artifact
	uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
	with:
	name: ${{ matrix.format }} build
	path: build/${{ matrix.format }}
	retention-days: 15

Provide feedback