Skip to content

Move docs workflows to elastic/docs-actions#5017

Merged
theletterf merged 1 commit intoelastic:mainfrom
Mpdreamz:migrate/docs-actions-workflows
Mar 30, 2026
Merged

Move docs workflows to elastic/docs-actions#5017
theletterf merged 1 commit intoelastic:mainfrom
Mpdreamz:migrate/docs-actions-workflows

Conversation

@Mpdreamz
Copy link
Copy Markdown
Member

Summary

Moves our docs CI/CD workflow logic from elastic/docs-builder to
elastic/docs-actions.
elastic/docs-builder has grown in scope; elastic/docs-actions lets the
docs team push updates to the @v1 tag independently without coupling to
the broader builder tooling.

The new setup follows GitHub's recommended two-phase workflow approach:
all required checks on pull requests now run with read-only access only.
Preview deployments and PR comments happen in a separate phase triggered
after the required check completes.

Replaces preview-build.yml and docs-cleanup.yml with three new workflow
files: docs-build.yml, docs-deploy.yml, and docs-preview-cleanup.yml.

Preview deployments for forks:
Preview deployments are not available for fork PRs by default. If you are an
Elastic employee working from a fork, previews will work once your Elastic
GitHub organization membership is set to Public:

  1. Go to https://github.com/orgs/elastic/people and find your name

  2. Open the visibility dropdown next to your name and select Public

    Or: GitHub profile -> Organizations -> Elastic logo -> set visibility
    to Public.

Contributors outside Elastic will still get build validation feedback on
their PRs -- only preview deployments are skipped.

Post-merge

  • Update branch protection rules to require docs-build instead of
    preview-build (if applicable)

cc @elastic/ingest-docs

Moves docs CI/CD from elastic/docs-builder to elastic/docs-actions.
Part of elastic/docs-eng-team#474
@Mpdreamz Mpdreamz requested review from a team as code owners March 30, 2026 11:09
@github-actions
Copy link
Copy Markdown

🤖 GitHub comments

Just comment with:

  • run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

@theletterf theletterf merged commit 5722fb1 into elastic:main Mar 30, 2026
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants