add release docs

Author: copelco

README.md

@@ -22,6 +22,7 @@ deployments yet.
 - [Approach](#approach)
 - [Plugin Development](#plugin-development)
   - [Automated Tests](#automated-tests)
+  - [Releasing](#releasing)
 
 ## Motivation
 
@@ -273,3 +274,28 @@ uv run pytest
 # To skip platform_agnostic_tests for faster feedback during plugin development:
 uv run pytest --ignore=tests/integration_tests/platform_agnostic_tests
 ```
+
+### Releasing
+
+1. Bump the version in `pyproject.toml`:
+   ```sh
+   uv version --bump patch  # or --bump minor/major
+   ```
+
+2. Add release notes to `CHANGELOG.md`
+
+3. Create a new release on GitHub:
+   - Tag the version (e.g., `v0.2.1`)
+   - Add the same release notes
+   - Publish the release
+
+   When the release is published, CI automatically builds and publishes the package to PyPI.
+
+<!-- omit in toc -->
+#### Test Release
+
+If you're testing a release, you can use `test.pypi.org` with a command like:
+
+```sh
+op run --env-file ../.testpypi -- uv publish --publish-url https://test.pypi.org/legacy/ 
+```