Skip to content

changelog: Cutover to remove NEXT_CHANGELOG.md - #5831

Merged
janniklasrose merged 3 commits into
mainfrom
janniklasrose/nextchangelog-cutover
Jul 14, 2026
Merged

changelog: Cutover to remove NEXT_CHANGELOG.md#5831
janniklasrose merged 3 commits into
mainfrom
janniklasrose/nextchangelog-cutover

Conversation

@janniklasrose

@janniklasrosejanniklasrose commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Changes

  • Remove NEXT_CHANGELOG.md — the .nextchanges/ system fully drives the release now, so nothing reads it anymore.
  • Migrate its two pending v1.7.0 entries to .nextchanges/ fragments (verified they render identically).
  • Update the remaining NEXT_CHANGELOG references in the onboard-team-area skill to .nextchanges/.

Why

Follow-up cutover to #5534. That PR left NEXT_CHANGELOG.md in the tree (unused) to stay focused; release_tagging.py already renders CHANGELOG.md straight from .nextchanges/ fragments. This deletes the now-vestigial file and its last references.

Tests

  • task check-changelog passes (fragments + version valid).
  • Confirmed release_tagging.py reads only .nextchanges/ (fragments + version), never NEXT_CHANGELOG.md, so the deletion changes no release behavior.
  • Rendering the two migrated fragments reproduces the original NEXT_CHANGELOG.md body byte-for-byte.

This pull request was written by Isaac, an AI coding agent.

@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: ff8914e

Run: 29322022351

Env🔄​flaky💚​RECOVERED🙈​SKIP✅​pass🙈​skipTime
💚​aws linux4423010845:22
💚​aws windows4423210828:00
💚​aws-ucws linux4431610015:49
💚​aws-ucws windows443189997:28
🔄​azure linux22423010837:27
💚​azure windows4423210817:46
💚​azure-ucws linux443189985:46
💚​azure-ucws windows443209968:38
💚​gcp linux4422910854:50
💚​gcp windows4423110836:52
8 interesting tests: 4 SKIP, 2 RECOVERED, 2 flaky
Test Nameaws linuxaws windowsaws-ucws linuxaws-ucws windowsazure linuxazure windowsazure-ucws linuxazure-ucws windowsgcp linuxgcp windows
💚​TestAccept💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R
🙈​TestAccept/bundle/invariant/no_drift🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/ssh/connection🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
💚​TestFetchRepositoryInfoAPI_FromRepo💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R
🔄​TestFetchRepositoryInfoAPI_FromRepo/root💚​R💚​R💚​R💚​R🔄​f💚​R💚​R💚​R💚​R💚​R
🔄​TestFetchRepositoryInfoAPI_FromRepo/subdir💚​R💚​R💚​R💚​R🔄​f💚​R💚​R💚​R💚​R💚​R
Top 10 slowest tests (at least 2 minutes):
durationenvtestname
6:58azure-ucws windowsTestAccept
6:40aws windowsTestAccept
6:28azure windowsTestAccept
6:07aws-ucws windowsTestAccept
6:02gcp windowsTestAccept
2:57aws linuxTestAccept
2:54azure linuxTestAccept
2:54aws-ucws linuxTestAccept
2:52gcp linuxTestAccept
2:46azure-ucws linuxTestAccept

@janniklasrosejanniklasrose changed the title Cut over: remove NEXT_CHANGELOG.mdchangelog: Cut-over to remove NEXT_CHANGELOG.mdJul 10, 2026
Base automatically changed from janniklasrose/changelog-merge-conflicts to mainJuly 10, 2026 16:55
@janniklasrosejanniklasrose changed the title changelog: Cut-over to remove NEXT_CHANGELOG.mdchangelog: Cutover to remove NEXT_CHANGELOG.mdJul 10, 2026
The .nextchanges/ system fully drives the release now (release_tagging.py
renders CHANGELOG.md straight from fragments), so NEXT_CHANGELOG.md is no longer
read by anything. Remove it, migrating its one pending v1.8.0 entry to a
.nextchanges/ fragment (verified it renders identically). Repoint a stale
NEXT_CHANGELOG.md reference in an acceptance test comment at CHANGELOG.md.
Co-authored-by: Isaac
@janniklasrose
janniklasroseforce-pushed the janniklasrose/nextchangelog-cutover branch from a014ca8 to ea67c50CompareJuly 10, 2026 17:10
Comment threadNEXT_CHANGELOG.md
@@ -1,15 +0,0 @@
# NEXT CHANGELOG

## Release v1.8.0

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note https://github.com/databricks/cli/blob/main/.nextchanges/version is already at 1.8.0 so no need for cutover

@janniklasrose
janniklasrose marked this pull request as ready for review July 10, 2026 17:12
bradleyjamrozik-origindigital pushed a commit to Origin-Digital-LLC/databricks-cli that referenced this pull request Jul 13, 2026
…t into files (databricks#5534)
## Changes
- Added `.nextchanges/` scaffolding (one file per entry, grouped by
section)
- Release renders fragments straight into `CHANGELOG.md` via a
repo-owned `internal/genkit/release_tagging.py` wrapper around the
synced `tagging.py`
- Release version tracked in `.nextchanges/version` (auto-bumped each
release)
- New `check-changelog` Taskfile target; `validate_nextchanges.py`
validates fragment placement + the version file
- Updated agent PR skill
## Why
Prevent common merge conflicts on the file during busy/productive times,
requiring manual action to rebase.
Why not `merge=union` in .gitattributes? Easy quality of life for local,
but unfortunately [not supported by
GitHub](https://github.com/orgs/community/discussions/9288).
## Tests
- e925f8d - add dummy entries into
`.nextchanges/` (mixed `* ` / `- ` / no marker)
- a339ab0 - simulate the release:
render into `CHANGELOG.md` (blank line after each heading, markers
normalized to ` * `), delete fragments, bump `version`
- `validate_nextchanges.py` rejects bad entries (each exits 1):
- misplaced fragment (unknown section dir) → `not in a known section
directory`
- empty fragment → `empty fragment`
- missing `.nextchanges/version` → `missing; expected the next release
version`
- malformed version → `not a valid semver version`
## Rollout (follow-up)
This PR already renders `.nextchanges/` directly into `CHANGELOG.md` at
release. `NEXT_CHANGELOG.md` is intentionally left in the tree, now
unused, to keep this PR focused.
**Follow-up cutover PR:** databricks#5831 `git rm NEXT_CHANGELOG.md` once nothing
references it. It's split out so this PR is easy to review and revert;
the deletion is mechanical.
_This pull request was written by Isaac, an AI coding agent._
@janniklasrose
janniklasrose added this pull request to the merge queueJul 14, 2026
Merged via the queue into main with commit 9b34ac4Jul 14, 2026
26 checks passed
@janniklasrose
janniklasrose deleted the janniklasrose/nextchangelog-cutover branch July 14, 2026 10:20
@eng-dev-ecosystem-bot

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: 9b34ac4

Run: 29325030226

Env❌​FAIL🟨​KNOWN🔄​flaky💚​RECOVERED🙈​SKIP✅​pass🙈​skipTime
🔄​aws linux644523101656:47
❌​aws windows6134480102962:02
🔄​aws-ucws linux862995826202:37
🔄​aws-ucws windows352943844205:57
🔄​azure linux734517101784:07
🔄​azure windows844472103087:47
💚​azure-ucws linux62898861181:38
🔄​azure-ucws windows352838879180:43
💚​gcp linux44514102253:06
💚​gcp windows44471103556:51
37 interesting tests: 24 flaky, 6 FAIL, 4 RECOVERED, 2 SKIP, 1 KNOWN
Test Nameaws linuxaws windowsaws-ucws linuxaws-ucws windowsazure linuxazure windowsazure-ucws linuxazure-ucws windowsgcp linuxgcp windows
🟨​TestAccept💚​R🟨​K💚​R🔄​f💚​R💚​R💚​R🔄​f💚​R💚​R
💚​TestAccept/bundle/invariant/no_drift🙈​S🙈​S💚​R💚​R🙈​S🙈​S💚​R💚​R🙈​S🙈​S
🔄​TestAccept/bundle/resources/apps/lifecycle-started✅​p✅​p✅​p✅​p🔄​f🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/apps/lifecycle-started-omitted✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct✅​p✅​p✅​p✅​p🔄​f🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/dashboards/change-name🔄​f✅​p🔄​f🔄​f✅​p✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/dashboards/change-name/DATABRICKS_BUNDLE_ENGINE=direct🔄​f✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/dashboards/change-name/DATABRICKS_BUNDLE_ENGINE=terraform✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/grants/registered_models🙈​s🙈​s✅​p✅​p🙈​s🙈​s✅​p🔄​f🙈​s🙈​s
🔄​TestAccept/bundle/resources/grants/registered_models/DATABRICKS_BUNDLE_ENGINE=terraform✅​p✅​p✅​p🔄​f
🔄​TestAccept/bundle/resources/grants/schemas/remove_principal🙈​s🙈​s🔄​f✅​p🙈​s🙈​s✅​p✅​p🙈​s🙈​s
🔄​TestAccept/bundle/resources/grants/schemas/remove_principal/DATABRICKS_BUNDLE_ENGINE=terraform🔄​f✅​p✅​p✅​p
🔄​TestAccept/bundle/resources/permissions/jobs/current_can_manage_run✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p🙈​s🙈​s
🔄​TestAccept/bundle/resources/permissions/jobs/current_can_manage_run/DATABRICKS_BUNDLE_ENGINE=direct✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions✅​p❌​F✅​p✅​p🙈​s🙈​s🙈​s🙈​s🙈​s🙈​s
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions/DATABRICKS_BUNDLE_ENGINE=direct🔄​f❌​F✅​p✅​p
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions/DATABRICKS_BUNDLE_ENGINE=terraform🔄​f❌​F✅​p✅​p
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions✅​p❌​F✅​p✅​p🙈​s🙈​s🙈​s🙈​s🙈​s🙈​s
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=direct🔄​f❌​F✅​p✅​p
❌​TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=terraform🔄​f❌​F✅​p✅​p
🔄​TestAccept/bundle/resources/postgres_databases/update🙈​s🙈​s🔄​f✅​p🙈​s🙈​s🙈​s🙈​s🙈​s🙈​s
🔄​TestAccept/bundle/resources/postgres_databases/update/DATABRICKS_BUNDLE_ENGINE=terraform🔄​f✅​p
💚​TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name🙈​S🙈​S💚​R💚​R🙈​S🙈​S💚​R💚​R🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🔄​TestAccept/bundle/templates/default-python/combinations/classic✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/combinations/classic/DATABRICKS_BUNDLE_ENGINE=terraform/DLT=no/NBOOK=yes/PY=no/READPLAN=✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=direct/UV_PYTHON=3.10✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=direct/UV_PYTHON=3.9✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=terraform/UV_PYTHON=3.10✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=terraform/UV_PYTHON=3.11✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=terraform/UV_PYTHON=3.12✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🔄​TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=terraform/UV_PYTHON=3.9✅​p✅​p✅​p✅​p✅​p🔄​f✅​p✅​p✅​p✅​p
🙈​TestAccept/ssh/connection🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
💚​TestFetchRepositoryInfoAPI_FromRepo💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R
💚​TestFetchRepositoryInfoAPI_FromRepo/root💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R💚​R
🔄​TestFetchRepositoryInfoAPI_FromRepo/subdir💚​R💚​R💚​R💚​R🔄​f💚​R💚​R💚​R💚​R💚​R
Top 50 slowest tests (at least 2 minutes):
durationenvtestname
12:38gcp linuxTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
12:34gcp windowsTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:42azure-ucws linuxTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:37aws-ucws linuxTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:17aws-ucws windowsTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:43azure-ucws windowsTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:29azure linuxTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:13aws linuxTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
9:06aws-ucws linuxTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:00azure linuxTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:43gcp linuxTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:30aws-ucws windowsTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:09gcp windowsTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:06azure-ucws linuxTestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=terraform
7:50gcp windowsTestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
7:47azure windowsTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:38azure-ucws linuxTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:30aws windowsTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:25aws linuxTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:21gcp linuxTestAccept/bundle/resources/clusters/deploy/local_ssd_count/DATABRICKS_BUNDLE_ENGINE=direct
7:12aws linuxTestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:12azure-ucws linuxTestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=direct
7:03gcp linuxTestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
6:46aws-ucws linuxTestAccept/bundle/resources/registered_models/basic/DATABRICKS_BUNDLE_ENGINE=terraform
6:43azure-ucws windowsTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
6:29aws-ucws linuxTestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=direct
6:25aws-ucws linuxTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
6:24azure windowsTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
6:19gcp windowsTestAccept/bundle/resources/clusters/deploy/local_ssd_count/DATABRICKS_BUNDLE_ENGINE=direct
6:16gcp windowsTestAccept
6:10gcp linuxTestAccept/bundle/resources/apps/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
5:59aws windowsTestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
5:55azure-ucws windowsTestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
5:38aws-ucws linuxTestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=direct
5:33aws-ucws windowsTestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
5:24aws-ucws windowsTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
5:22aws-ucws linuxTestAccept/bundle/resources/secret_scopes/permissions/DATABRICKS_BUNDLE_ENGINE=terraform
5:21aws-ucws linuxTestAccept/bundle/resources/models/basic/DATABRICKS_BUNDLE_ENGINE=terraform
5:19azure windowsTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
5:19gcp windowsTestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=terraform
5:17azure-ucws windowsTestAccept/bundle/resources/models/basic/DATABRICKS_BUNDLE_ENGINE=terraform
5:14aws-ucws linuxTestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=terraform
5:11azure linuxTestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=direct
5:08gcp linuxTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
5:08azure-ucws linuxTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
4:59gcp windowsTestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
4:56aws-ucws windowsTestAccept/bundle/apps/job_permissions/DATABRICKS_BUNDLE_ENGINE=terraform
4:55azure-ucws windowsTestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=terraform
4:54aws-ucws windowsTestAccept/bundle/resources/registered_models/basic/DATABRICKS_BUNDLE_ENGINE=terraform
4:52gcp windowsTestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct

ronaldz-db pushed a commit to ronaldz-db/cli that referenced this pull request Jul 15, 2026
…sue databricks#4179 (databricks#5923)
The fragment added by databricks#5831 linked the `env:` section changelog entry to
the original issue (databricks#4179) rather than the PR that implemented the
feature (databricks#5299). This includes both links.
Sign up for freeto 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

@janniklasrose@eng-dev-ecosystem-bot@pietern