Quy trình phát hành
Versioning
- Dùng
setuptools_scm (xem pyproject.toml) để suy luận phiên bản từ thẻ Git.
- Tạo thẻ theo mẫu:
vX.Y.Z hoặc vX.Y.Z.devN cho bản phát triển.
Chuẩn bị phát hành
- Đảm bảo test xanh:
pytest -v.
- Soát tài liệu: liên kết/chỉ mục/nav cập nhật.
- Cập nhật
docs/vi/changelog.md với nội dung phát hành.
Đóng gói
python -m build
twine check dist/*
# (tuỳ chọn) twine upload dist/*
Phát hành tài liệu
- Build site tĩnh bằng MkDocs (thực hiện sau khi nội dung ổn định).
- CI (sau): build preview trên PR, publish khi merge
main.
Ghi chú phát hành
- Tóm tắt thay đổi chính của mã và tài liệu.
- Link tới các PR liên quan; liệt kê điểm phá vỡ (breaking changes) nếu có.