Add API synopsis titles and cross references #781

	# Copyright 2021-2024 The Khronos Group, Inc.
	# SPDX-License-Identifier: Apache-2.0

	# CI to build asciidoctor spec targets, on push or manually

	name: CI

	# Controls when the action will run.
	on:
	# Triggers the workflow on push or manual dispatch
	push:

	branches:

	tags:

	# Also build when some pull requests are created
	pull_request:

	# Allows you to run this workflow manually from the Actions tab
	workflow_dispatch:

	jobs:
	build:
	# The type of runner that the job will run on
	runs-on: ubuntu-latest

	# Use Khronos container with asciidoctor toolchain preinstalled
	container: khronosgroup/docker-images:asciidoctor-spec

	steps:
	# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
	- uses: actions/checkout@v4

	# Unfortunately, asciidoctor-pdf gets pathname-specific errors
	# building under the usual $GITHUB_WORKSPACE (/__w). As a workaround,
	# generate the outputs in /tmp.

	- name: Build spec targets
	run: \|
	cd adoc
	make OUTDIR=/tmp/out QUIET= html pdf
	- name: Verify reflow conformance
	run: \|
	./adoc/scripts/verify_reflow_conformance.sh
	- name: Archive generated files
	uses: actions/upload-artifact@v3
	with:
	name: spec-outputs
	path: \|
	/tmp/out

Provide feedback