docs: add README for build/scripts

Quick reference for each script, CQA usage, and workflow mappings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: themr0c

build/scripts/README.md

@@ -0,0 +1,35 @@
+# Build Scripts
+
+Build, deploy, and content quality tooling for the RHDH documentation project.
+
+## Scripts
+
+| Script | Purpose |
+|---|---|
+| `build-ccutil.sh` | Wrapper that delegates to `build-orchestrator.js`. Used by `build-asciidoc.yml` and as a fallback in `pr.yml` on older branches. |
+| `build-orchestrator.js` | Parallel documentation build orchestrator. Runs ccutil title builds, lychee link validation, and CQA assessment. Produces `build-report.json`. |
+| `deploy-gh-pages.js` | Deploys build output to the `gh-pages` branch. Handles cleanup of stale PR/branch directories, index regeneration with release notes links, and retry with rebase on push conflicts. |
+| `error-patterns.json` | Regex patterns for classifying ccutil build errors into structured messages with cause and fix fields. |
+| `update-cqa-resources.sh` | Fetches upstream Red Hat style guide resources into `.claude/resources/`. |
+
+## CQA (`cqa/`)
+
+Content Quality Assessment framework with 19 checks (CQA-00a through CQA-17).
+
+```bash
+node build/scripts/cqa/index.js titles/<title>/master.adoc           # report
+node build/scripts/cqa/index.js --fix titles/<title>/master.adoc     # auto-fix
+node build/scripts/cqa/index.js --check 14 titles/<title>/master.adoc # single check
+node build/scripts/cqa/index.js --all                                 # all titles
+```
+
+See `.claude/plugins/project-cqa/resources/cqa-spec.md` for the full specification.
+
+## Workflows
+
+These scripts are called by GitHub Actions workflows in `.github/workflows/`:
+
+- **`build-asciidoc.yml`** (push to main/release) -- `build-ccutil.sh` + `deploy-gh-pages.js`
+- **`pr.yml`** (pull requests) -- `build-orchestrator.js` (or `build-ccutil.sh` on older branches) + `deploy-gh-pages.js`
+
+See `docs/github-publication-workflow.md` for the full architecture documentation.