Skip to content

Verify the shared preview steps on a docs change - #4625

Closed
akira28 wants to merge 10 commits into
mainfrom
verify/preview-composites
Closed

akira28 wants to merge 10 commits into
mainfrom
verify/preview-composites

Conversation

@akira28

@akira28 akira28 commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

Throwaway draft PR that exercises the shared preview steps from #4619 against main, because the docs preview only deploys for PRs whose base is a content source branch. It is closed without merging once both previews deploy.

Affects: Deploys & previews

Why

#4619 moves the deployment, upload and cleanup steps into shared actions. Its own runs skipped the docs preview because nothing under docs/ changed, and a draft against the feature branch (#4624) skipped it too because assembler-match only matches main.

What

A docs change on top of the feature branch

One paragraph appended to docs/development/essc.md, which makes the docs preview build and upload through the new composites in the merge commit. The assembler preview runs on every PR regardless.

Verify

Both previews report a deployment status on this PR.

🤖 Generated with Claude Code

akira28 and others added 10 commits October 28, 2026 10:26
A PR that only touches `.libra/`, `CODEOWNERS` or similar files still runs the full build, smoke tests and assembler preview. A new `changes.yml` reports whether a PR touches anything beyond that metadata, and the slow workflows gate on it. The matrix checks that branch protection requires gate per step, so they still report.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ilter

The assembler preview now has two jobs, so zizmor flags its workflow-level write permissions. They move to the `build` job. The zizmor path filter also covers `action.yml` and `actions/`, which zizmor audits.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
`ci.yml` already had an inline `changes` job with per-area filters, and the new `scope` check duplicated that mechanism. `changes.yml` now holds every filter, and the three workflows call it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The filters become glob lists that `tj-actions/changed-files` evaluates, the same action `docs-preview-local.yml` already pins. The workflow no longer needs a checkout on pull requests. Callers grant `pull-requests: read` for the API diff.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
`changed-files` reports only a rename's destination by default. Moving a file out of a lambda's inputs, or into `.libra/`, then skipped builds the old `git diff --no-renames` filter would have run.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The `code` filter lists the metadata paths and reads `only_modified` instead of negating them from `**`. The shared build inputs are one anchor reused by both lambda filters, and job outputs compute their values inline, which removes the shell step.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The assembler preview and the docs preview each carried their own copy of the deployment bookkeeping, the S3 sync with CloudFront invalidation, and the closed-PR cleanup. These become `deployment-start`, `deployment-finish` and `upload-preview` composite actions plus a reusable `preview-cleanup.yml`. The docs preview ignore list is defined once, and the assembler preview drops a `setup-node` step that `bootstrap` already ran.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
# Conflicts:
#	.github/workflows/docs-preview-local.yml
`preview-cleanup.yml` looks deployments up by the task `<environment>-<pr number>`,
while the two callers of `deployment-start` spelled that name out by hand. The
action now takes a `pr-number` input and builds the task itself, so the name
cannot drift between the three files.

`assembler-preview-cleanup.yml` loses its `workflow_call` trigger: no repository
calls it, and a nested `$/` reference would not resolve for an external caller.
The unused `deployment_result` output in `docs-preview-local.yml` goes too.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Throwaway change for the verification run of
#4619. The PR closes without merging.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Docs preview (local build)

Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4625/

Sample changed pages:

@akira28 akira28 closed this Oct 28, 2026
@akira28
akira28 deleted the verify/preview-composites branch October 28, 2026 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant