Skip to content

changelog: wire --repo/--owner and document artifact-root S3 layout#199

Open
cotti wants to merge 3 commits into
mainfrom
feature/folder_structure
Open

changelog: wire --repo/--owner and document artifact-root S3 layout#199
cotti wants to merge 3 commits into
mainfrom
feature/folder_structure

Conversation

@cotti

@cotti cotti commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a branch input (defaults to github.ref_name) and forwards it to docs-builder changelog upload as --branch, so changelog entries are uploaded under the per-branch pool changelog/{org}/{repo}/{branch}/... of the new artifact-root layout. --owner/--repo are already passed (the org/repo segments).
  • Relaxes the upload gate from a hard main/master check to any branch push (tags and detached refs are still rejected), enabling changelog uploads from release/feature branches; validates the branch input.
  • Updates the changelog READMEs for the new S3 key contracts (bundle/{product}/..., changelog/{org}/{repo}/{branch}/...) and the per-org/repo/branch entry pool used by upload and CDN sourcing.

Depends on the Option AD + org/repo/branch key layout in elastic/docs-builder#3562. Refs elastic/docs-eng-team#413.

Test plan

  • No workflow logic changed beyond the new branch input/flag and the relaxed branch gate (env vars REPO_NAME/OWNER already available; branch defaults to github.ref_name).
  • Reusable changelog-upload / changelog-bundle workflows run green once the docs-builder change ships on the consumed version.

Made with Cursor

Pass --repo/--owner to `docs-builder changelog upload` so changelog entries are
keyed by the authoring repo (changelog/{repo}/...), and update the changelog
READMEs for the new key contracts (bundle/{product}/..., changelog/{repo}/...)
and the {repo}-{dateOrVersion}.yaml bundle filename convention.

Refs elastic/docs-eng-team#413

Co-authored-by: Cursor <cursoragent@cursor.com>
@cotti cotti requested a review from a team as a code owner June 24, 2026 16:29
@cotti cotti requested a review from reakaleek June 24, 2026 16:29
@github-actions

Copy link
Copy Markdown

Label error. Requires exactly 1 of: automation, breaking, bug, changelog:skip, chore, ci, dependencies, documentation, enhancement, feature, fix. Found:

cotti added 2 commits June 30, 2026 11:14
Adds a `branch` input (defaults to github.ref_name) and forwards it to
`docs-builder changelog upload` as `--branch`, so entries are uploaded under
the per-branch pool (changelog/{org}/{repo}/{branch}/...). Relaxes the upload
gate from a hard main/master check to any branch push (rejecting tags and
detached refs) and validates the branch input.
Reflects the org/branch nesting in the upload + CDN-sourcing docs:
changelog/{org}/{repo}/{branch}/{file} and registry.json, branch resolution,
and that uploads can now run from any branch (not just the default).
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.

1 participant