These notes are for you, the LLM, to help guide development and releases.
- Update Changelog:
- Update
CHANGELOG.md
with changes in the new version. - Add an entry for each change under the appropriate category (Added, Changed, Fixed, etc.).
- Use the date format
YYYY-MM-DD
.
- Update
- Increment Version:
- Increment the version number in
pyproject.toml
andplexsearch/__init__.py
. - Follow Semantic Versioning:
MAJOR.MINOR.PATCH
- MAJOR: Incompatible API changes (only relevant after version 1.0.0).
- MINOR: New, backwards-compatible functionality.
- PATCH: Backwards-compatible bug fixes.
- Increment the version number in
- Create Commit:
- Commit changes with a descriptive message, e.g.,
build: Bump version to 0.2.0
.
- Commit changes with a descriptive message, e.g.,
- Poetry Build and Publish:
- Run
poetry build
to build the package. - Run
poetry publish
to publish the package to PyPI.
- Run
- Create Git Tag:
- Create an annotated tag:
git tag -a v0.2.0 -m "Release v0.2.0"
- Push the tag:
git push origin v0.2.0
- Create an annotated tag:
- In the future, increment the MINOR version for significant changes, not just the PATCH version.
- The MINOR version should have been incremented for previous versions that added new features.
- Example: The addition of interactive mode should have bumped the version to
0.2.0
. - The current version is
0.2.0
. - The next version should be
0.3.0
.
- We've been working on a Python tool called
plexsearch
that uses the Perplexity API. - We've implemented an interactive mode.
- We've discussed and addressed a bug related to alternating user/assistant roles in the interactive mode.
- We've released version
0.2.0
which includes the interactive mode. - We've gone through a release process, including updating the changelog, bumping the version to
0.2.0
, building and publishing the package, and creating a Git tag. - The user committed the final changes for the
0.1.16
release with git hashcd852b2
and commit message "docs: Remove bugfix from changelog for v0.1.16". - The user committed the changes for LLM_DEV_NOTES with git hash
9809833
and commit message "docs: Add developer notes for release process and versioning". - The user ran
poetry build
andpoetry publish
for version0.1.16
. - The user ran
git tag -a v0.1.16 -m "Release v0.1.16"
andgit push origin v0.1.16
to create and push the Git tag for version0.1.16
.
- These notes are intended to provide context and guidance for future development.
- Remember to consider these points during the next release cycle.
- The user will likely ask you to help with the next release, so keep this information in mind.