This document outlines the release process for markitdown-mcp.
We follow Semantic Versioning:
- MAJOR version for incompatible API changes
- MINOR version for backwards-compatible functionality additions
- PATCH version for backwards-compatible bug fixes
-
Update Version
- Update version in
pyproject.toml - Update version in
markitdown_mcp/__init__.py
- Update version in
-
Update Changelog
- Add release notes to CHANGELOG.md
- Include all changes, fixes, and new features
-
Create Release
- Tag the release:
git tag -a v1.0.0 -m "Release v1.0.0" - Push tags:
git push origin --tags
- Tag the release:
-
Publish to PyPI
- Build:
python -m build - Upload:
python -m twine upload dist/*
- Build:
GitHub Actions automatically publishes to PyPI when a new tag is pushed.