From 0a59540bd39de9bf420813e953609b112ce11b70 Mon Sep 17 00:00:00 2001 From: Jan Rose Date: Wed, 23 Sep 2026 18:46:02 +0200 Subject: [PATCH 1/2] Give AIR its own nextchanges slug --- .agents/rules/changelog.md | 2 +- .agents/skills/pr-checklist/SKILL.md | 3 ++- .codegen.json | 1 + .github/CODEOWNERS | 1 + .nextchanges/README.md | 1 + .nextchanges/air/README.md | 6 ++++++ 6 files changed, 12 insertions(+), 2 deletions(-) create mode 100644 .nextchanges/air/README.md diff --git a/.agents/rules/changelog.md b/.agents/rules/changelog.md index 6dc7868cb8e..f5099a0c98e 100644 --- a/.agents/rules/changelog.md +++ b/.agents/rules/changelog.md @@ -5,4 +5,4 @@ globs: - ".nextchanges/**" --- -**RULE: Do not add new release entries to `CHANGELOG.md`.** For a user-visible change, add a fragment file under `.nextchanges/
/` (sections: `notable-changes`, `cli`, `bundles`, `dependency-updates`, `api-changes`). Each PR adds its own file, so entries never conflict. `CHANGELOG.md` is generated automatically from these fragments by the release process — never hand-edit it. See `.nextchanges/README.md`. +**RULE: Do not add new release entries to `CHANGELOG.md`.** For a user-visible change, add a fragment file under `.nextchanges/
/` (sections: `notable-changes`, `cli`, `air`, `bundles`, `dependency-updates`, `api-changes`). Each PR adds its own file, so entries never conflict. `CHANGELOG.md` is generated automatically from these fragments by the release process — never hand-edit it. See `.nextchanges/README.md`. diff --git a/.agents/skills/pr-checklist/SKILL.md b/.agents/skills/pr-checklist/SKILL.md index e1f772680ab..88546d02d0e 100644 --- a/.agents/skills/pr-checklist/SKILL.md +++ b/.agents/skills/pr-checklist/SKILL.md @@ -59,6 +59,7 @@ Add a changelog fragment under `.nextchanges/` when your change is user-visible. **When to add an entry:** - New or changed CLI command, flag, or subcommand behavior +- User-visible change to a `databricks air` command, including preview commands (put it under `air`) - New or changed bundle config field, schema, or engine behavior - New direct dependency (annotate under `Dependency updates`) - Bug fix that users will notice @@ -69,7 +70,7 @@ Add a changelog fragment under `.nextchanges/` when your change is user-visible. - Auto-generated output changes without a corresponding user-facing change **How to add:** -- Create `.nextchanges/
/.md`, picking the section folder that fits: `cli`, `bundles`, `dependency-updates`, `notable-changes`, or `api-changes`. `` is arbitrary (a feature name or your PR number) — just keep it unique. +- Create `.nextchanges/
/.md`, picking the section folder that fits: `cli`, `air`, `bundles`, `dependency-updates`, `notable-changes`, or `api-changes`. `` is arbitrary (a feature name or your PR number) — just keep it unique. - Write a single line in user-facing language, no Jira links: start it with a `* ` bullet marker and end it with a period. - **Voice and tense: imperative mood, active voice.** Lead with a verb that names the change — `Add`, `Fix`, `Bump`, `Remove`, `Deprecate`, `Support`, `Reject`, `Warn` — and describe the user-facing effect, not the implementation. Never use past tense (`Added`/`Fixed`) or first person (`we`/`I`/`our`). When a change reads better as a resulting behavior than as a verb, lead with the affected command, flag, or field in the present tense with "now". - GOOD: Add support for the `cluster_policies` resource type. diff --git a/.codegen.json b/.codegen.json index 0866ebe7ae9..990e248ed56 100644 --- a/.codegen.json +++ b/.codegen.json @@ -11,6 +11,7 @@ "nextchanges_sections": { "notable-changes": "Notable Changes", "cli": "CLI", + "air": "AI Runtime", "bundles": "Bundles", "dependency-updates": "Dependency Updates", "api-changes": "API Changes" diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 83beb1450f5..13ae00d7e2d 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -77,6 +77,7 @@ # AI Runtime /cmd/air/ @databricks/eng-deco-cli @databricks/eng-ai-custom-training /acceptance/air/ @databricks/eng-deco-cli @databricks/eng-ai-custom-training +/.nextchanges/air/ @databricks/eng-deco-cli @databricks/eng-ai-custom-training # CLI compatibility manifest /internal/build/cli-compat.json @databricks/eng-deco-cli @databricks/eng-apps-devex @databricks/eng-deco-platform diff --git a/.nextchanges/README.md b/.nextchanges/README.md index a759579d823..8a1c8a843ab 100644 --- a/.nextchanges/README.md +++ b/.nextchanges/README.md @@ -42,6 +42,7 @@ type the path (e.g. `.nextchanges/cli/quickstart.md`), write the entry, commit. | --- | --- | | `.nextchanges/notable-changes/` | Notable Changes (prominent, called out at the top) | | `.nextchanges/cli/` | CLI | +| `.nextchanges/air/` | AI Runtime | | `.nextchanges/bundles/` | Bundles | | `.nextchanges/dependency-updates/` | Dependency updates | | `.nextchanges/api-changes/` | API Changes | diff --git a/.nextchanges/air/README.md b/.nextchanges/air/README.md new file mode 100644 index 00000000000..ade85d47f04 --- /dev/null +++ b/.nextchanges/air/README.md @@ -0,0 +1,6 @@ +# AI Runtime + +Fragments here render under **AI Runtime** in the released changelog. Add a +.md file describing your change. + +See [`../README.md`](../README.md) for how fragments are written and released. From 1e5e35d84282c0573be6e6d976f1544f356a8768 Mon Sep 17 00:00:00 2001 From: Jan Rose Date: Wed, 23 Sep 2026 18:46:11 +0200 Subject: [PATCH 2/2] Fix typo --- .nextchanges/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.nextchanges/README.md b/.nextchanges/README.md index 8a1c8a843ab..679211f0b40 100644 --- a/.nextchanges/README.md +++ b/.nextchanges/README.md @@ -44,7 +44,7 @@ type the path (e.g. `.nextchanges/cli/quickstart.md`), write the entry, commit. | `.nextchanges/cli/` | CLI | | `.nextchanges/air/` | AI Runtime | | `.nextchanges/bundles/` | Bundles | -| `.nextchanges/dependency-updates/` | Dependency updates | +| `.nextchanges/dependency-updates/` | Dependency Updates | | `.nextchanges/api-changes/` | API Changes | See [`.agents/skills/pr-checklist/SKILL.md`](../.agents/skills/pr-checklist/SKILL.md)