diff --git a/README.md b/README.md
index dff1479..6537ca9 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,14 @@ This repo root contains the 4 scripts for the full provider build pipeline.
 3) Build and upload provider binaries for 3 OS targets
 4) Build and publish documentation site
 
+## Documentation publishing instructions
+
+The verified documentation generation and publishing pipeline is documented in
+[`HISTORY/2026-09-03_docs_upload_pipeline_verified.md`](HISTORY/2026-09-03_docs_upload_pipeline_verified.md).
+It covers the generated docs source, MkDocs build, the separate documentation
+S3 bucket, VM upload and mirror steps, stand-specific URLs, and the legacy
+script that must not be used.
+
 ## Prerequisites
 
 - Go 1.22+