From 5ac6390f1031d0023e62964cd82b582022b48769 Mon Sep 17 00:00:00 2001 From: Martijn Laarman Date: Tue, 28 Apr 2026 21:04:16 +0200 Subject: [PATCH 1/2] Pass PATH_PREFIX into docs-preview-local build docs-builder emits root-relative URLs by default; set --path-prefix to match preview S3 layout so `/ _static/` and links resolve under `/elastic/docs-builder/tree/...` on docs-v3-preview. Made-with: Cursor --- .github/workflows/docs-preview-local.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/docs-preview-local.yml b/.github/workflows/docs-preview-local.yml index 5eb51bf3a1..51c9096e74 100644 --- a/.github/workflows/docs-preview-local.yml +++ b/.github/workflows/docs-preview-local.yml @@ -302,7 +302,7 @@ jobs: && needs.check.outputs.any_modified != 'false' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) run: | - dotnet run --project src/tooling/docs-builder -- --strict + dotnet run --project src/tooling/docs-builder -- --strict --path-prefix "${PATH_PREFIX}" - name: 'Validate inbound links' if: > From 7316a8ba2c40c453817632c6ee0e0668e7673cd5 Mon Sep 17 00:00:00 2001 From: Martijn Laarman Date: Tue, 28 Apr 2026 21:04:56 +0200 Subject: [PATCH 2/2] Docs: link local authoring from handbook home Adds a handbook index entry so merges include a docs-path change alongside the preview workflow update, triggering Docs preview local on main. Made-with: Cursor --- docs/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/index.md b/docs/index.md index 22927502ff..73d859b168 100644 --- a/docs/index.md +++ b/docs/index.md @@ -9,6 +9,7 @@ Elastic Docs V3 is our next-generation documentation platform designed to improv ## What do you want to do today? * [Contribute to Elastic documentation](https://www.elastic.co/docs/contribute-docs/) +* [Edit and preview this handbook locally](./contribute/locally.md) * [Learn about V3 syntax](./syntax/index.md) * [Configure content sets in V3](./configure/index.md) * [Explore CLI commands](./cli/index.md)