Breaking changes (API modifications, removals, renames)
New features (APIs, CLI flags, configuration)
Deprecations
Configuration changes (CLI flags, environment variables)

3. Generate Draft Entries

Present draft entries for review BEFORE editing files. Match the formatting conventions by reading existing entries in each file.

4. Edit Documentation

After approval, add entries to the appropriate files.

Migration Notes Format

File: docs/docs-developers/docs/resources/migration_notes.md

Add entries under ## TBD section:

### [Component] Brief description

Explanation of what changed.

**Migration:**

```diff
- old code
+ new code
```

Impact: Effect on existing code.

Component tags: [Aztec.nr], [Aztec.js], [PXE], [Aztec Node], [AVM], [L1 Contracts], [CLI]

Node Operator Changelog Format

File: docs/docs-operate/operators/reference/changelog/v{major}.md

Breaking changes:

### Feature Name

**v{previous}:**
```bash
--old-flag <value>                    ($OLD_ENV_VAR)
```

**v{current}:**
```bash
--new-flag <value>                    ($NEW_ENV_VAR)
```

**Migration**: How to migrate.

New features:

### Feature Name

```bash
--new-flag <value>                    ($ENV_VAR)
```

Description of the feature.

Changed defaults: Use table format with Flag, Environment Variable, Previous, New columns.

updating-changelog

Updating Changelog

Steps

1. Determine Target Files

2. Analyze Branch Changes