Thank you for your interest in contributing to wish! This document provides guidelines and instructions for contributing to this project.
Each package (wish-*/
) contains its own README.md with specific development instructions.
All notable changes to the wish project should be documented in the CHANGELOG.md file.
When making changes:
- Add your changes to the
[Unreleased]
section of CHANGELOG.md - Categorize your changes under the appropriate heading:
Added
for new featuresChanged
for changes in existing functionalityFixed
for bug fixesRemoved
for removed features
- Prefix your entry with the affected package name in square brackets, e.g.,
[wish-models]
Example:
### Added
- [wish-models] New data model for command history
- [wish-sh] New UI component for displaying command suggestions
To release a new version:
- Ensure all changes are properly documented in CHANGELOG.md
- Use GitHub Actions UI: https://github.com/SecDev-Lab/wish/actions/workflows/publish.yml
- Enter the new version number when prompted
- The workflow will:
- Update the version in all package pyproject.toml files
- Build and publish the packages to PyPI
- Update CHANGELOG.md by converting the Unreleased section to the new version
- Create a GitHub release with the CHANGELOG content