[DOCS] Describe workflow for amending changelog bundle notes - #4073
Merged
Merged
Conversation
Contributor
Docs preview (local build)Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4073/ Sample changed pages: |
Mpdreamz
approved these changes
Sep 14, 2026
Mpdreamz
left a comment
Member
There was a problem hiding this comment.
Reviewed the docs-only workflow update. The late-note guidance is consistent across the CLI and release-notes pages, the reserved .amend-notes ownership is clear, and CI is green. Looks ready once the PR is out of draft.
Contributor
There was a problem hiding this comment.
Approved.
What is this? | From workflow: PR Review
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
Contributor
There was a problem hiding this comment.
Requesting changes.
What is this? | From workflow: PR Review
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Document adding and removing notes from published bundles
Relates to #4072 (documentation of all but the missing functionality)
Details
Canonical how-to is now a subsection of Amend bundles: Add or remove notes after a bundle ships.
Add a late note:
changelog note→changelog upload --artifact-type changelog. Do not usebundle-amend --add; the scrubber writes{parent}.amend-notes.yaml.Remove: local
changelog removenever changes published bundles. Notes already in the parent can usebundle-amend --removeplus uploadingamend-N. Notes that exist only in.amend-noteshave no unpublish command. A warning covers the scrubber putting a still-published pool file back.The same facts are linked from
cmd-note.md,cmd-bundle-amend.md,create.md,cmd-remove.md,overview.md,cmd-upload.md, andchangelog-bundle-registry.md. None of those pages tell authors to delete S3 objects.Generative AI disclosure
Tool(s) and model(s) used: Cursor Grok 4.6