Save this content to: .cursor/rules/release-process.mdc

---
package: sentry/sentry-symfony
source_path: .cursor/rules/release-process.mdc
repo: https://github.com/getsentry/sentry-symfony
---

---
globs: CHANGELOG.md
alwaysApply: false
---
# Sentry Symfony SDK Release Process

## Release Process

To prepare a new release (e.g., version 4.14.0):

1. **Update master branch**: Always ensure master is up-to-date first
   ```bash
   git checkout master
   git pull origin master
   ```

2. **Create release branch**: Create a branch named `prepare-X.Y.Z`
   ```bash
   git checkout -b prepare-4.14.0
   ```

3. **Find changes since last release**: Check commits since the last version tag
   ```bash
   git log --oneline --no-merges 4.13.0..HEAD
   ```

4. **Update CHANGELOG.md**: Add new version section with:
   - Version number and announcement text
   - Features section for new features
   - Bug Fixes section for bug fixes
   - Misc section for documentation/readme updates
   - Use format: `- Description [(#PR)](mdc:https:/github.com/getsentry/sentry-symfony/pull/PR)`

## CHANGELOG.md Format

```markdown
## X.Y.Z

The Sentry SDK team is happy to announce the immediate availability of Sentry PHP SDK vX.Y.Z.

### Features

- New feature description [(#1234)](mdc:https:/github.com/getsentry/sentry-php/pull/1234)

### Bug Fixes

- Bug fix description [(#1235)](mdc:https:/github.com/getsentry/sentry-php/pull/1235)

### Misc

- Documentation/misc changes [(#1236)](mdc:https:/github.com/getsentry/sentry-php/pull/1236)
```

## Committing Changes

After updating CHANGELOG.md:

1. **Stage only the changelog**: `git add CHANGELOG.md`
2. **Create simple commit**: `git commit -m "Prepare X.Y.Z"`
   - Use simple commit message format
   - Don't include additional descriptions or generated tags

## Common Commands

- Check git status: `git status`
- View recent commits: `git log --oneline -10`
- Create branch: `git checkout -b branch-name`
- Update from remote: `git pull origin master`