(releasing)=

# Releasing

## Version policy

libvcs is pre-1.0. Any minor bump (e.g. 0.39 to 0.40) **may** contain
breaking changes. Patch bumps (0.39.0 to 0.39.1) are reserved for
bug-fixes and documentation.

## Checklist

1. Ensure `CHANGES` lists every merged PR since the last tag. Credit
   contributors by GitHub handle.

2. Update the version in `src/libvcs/__about__.py` **and**
   `pyproject.toml`.

3. Commit and tag:

   ```console
   $ git commit -m 'Tag v0.39.1'
   ```

   ```console
   $ git tag v0.39.1
   ```

4. Push the commit and tag -- CI will publish to PyPI automatically:

   ```console
   $ git push && git push --tags
   ```

## Manual publish (fallback)

```console
$ uv build
```

```console
$ uv publish
```