Skip to content

CHANGELOG: Sort "unreleased" changes under their release versions - #980

Merged
marcleblanc2 merged 2 commits into
mainfrom
marc/changelog-release-headings
Oct 29, 2026
Merged

marcleblanc2 merged 2 commits into
mainfrom
marc/changelog-release-headings

Conversation

@marcleblanc2

@marcleblanc2 marcleblanc2 commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

The sourcegraph chart CHANGELOG had 28 bullets under Unreleased, going back to changes that shipped in 6.1.0. This moves each bullet under the release it first shipped in; nothing is reworded.

For each bullet I checked the charts/sourcegraph/CHANGELOG.md shipped in every v* tag and took the lowest version containing it (cross-checked against git tag --contains on the commit that added it; both methods agree):

Release Bullets
Unreleased outbound-http-proxy example, codeintel-db PVC name fix, indexedSearch.readinessProbe / indexedSearch.livenessProbe, searcher.storageSize quantity parsing (all newer than v8.1.2687)
8.1.0 Redis config management (2 bullets)
8.0.0 network-policy example, object storage example fix, code intel worker ports, grafana.initContainers, gitserver.storageAccessModes, graceful shutdown, syntect/searcher PDBs, DEPLOY_TYPE=helm
7.7.0 grafana extraContainers fix, searcher.autoCacheSize
7.6.0 OTel trace processor ordering, executor /data PVC + replicas removal
7.4.0 per-replica worker replicaCount, per-service image.repository
7.2.0 zoekt-webserver livenessProbe
6.4.0 repo-updater and symbols removal
6.2.0 gitserver startup probe
6.1.0 frontend PDB fix

sourcegraph-executor chart

The executor CHANGELOG had four bullets under Unreleased and no release headings at all. Same method, same result: nothing reworded.

Release Bullets
8.0.0 executor network-policy example
7.0.2852 securityContext deprecation in sourcegraph-executor-k8s (not in v7.0.0 or v7.0.2178)
5.3.9104 new sourcegraph-executor-k8s chart, rename to sourcegraph-executor-dind (v5.3.9104 is the oldest tag in the repo, so these shipped there or earlier)

Note the four oldest bullets predate the current main history (it re-roots at c7b92eb); their versions come from the v6.x tags, which still carry the old history.

Checklist

Test plan

Docs only. Verified the set of bullet lines in both files is byte-identical to main (only headings added). markdownlint-cli2 reports the same 65 pre-existing findings on the sourcegraph CHANGELOG before and after, and 7 → 5 on the executor one (blank lines around the new headings).

@github-actions

github-actions Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Each bullet under Unreleased was matched against the CHANGELOG shipped
in every release tag, and moved under the lowest version whose chart
contains it. Five bullets newer than v8.1.2687 stay under Unreleased.

Amp-Thread-ID: https://ampcode.com/threads/T-01a16525-9761-7145-85e0-86c81f2f1ac8
Co-authored-by: Amp <amp@ampcode.com>
@marcleblanc2
marcleblanc2 force-pushed the marc/changelog-release-headings branch from d9cf38d to ee1b286 Compare October 29, 2026 22:13
@marcleblanc2
marcleblanc2 requested a review from a team October 29, 2026 22:19
@marcleblanc2 marcleblanc2 changed the title CHANGELOG: file released changes under their release headings CHANGELOG: Sort "unreleased" changes under their release versions Oct 29, 2026
…eadings

Same method as the sourcegraph chart: each bullet under Unreleased was
matched against the CHANGELOG shipped in every release tag, and moved
under the lowest version whose chart contains it. The two oldest bullets
are in v5.3.9104, the oldest tag in the repo, so they shipped there or
earlier. Nothing remains under Unreleased.

Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-01a189b8-62b4-7754-af9e-46f9d940d0c7
@marcleblanc2
marcleblanc2 merged commit 1a534af into main Oct 29, 2026
7 checks passed
@marcleblanc2
marcleblanc2 deleted the marc/changelog-release-headings branch October 29, 2026 23:12
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.

2 participants