Thanks for your interest in contributing to Dift.
We welcome thoughtful contributions that improve the project for real users.
Dift is an open-source tool for comparing datasets and building trust in data changes.
We value contributions that improve usability, reliability, performance, documentation clarity, test coverage, and developer experience.
- Bug fixes
- New comparison features
- Performance improvements
- File format support
- Better CLI UX
- Better reports
- Improve README clarity
- Add examples
- Improve installation guides
- Fix incorrect docs
- Add tests
- Improve CI workflows
- Refactor maintainable code
- Fork the repository
- Clone your fork
- Create a new branch
- Set up the project (venv + install)
- Make your changes
- Test your changes (pytest, ruff)
- Commit your work
- Push to your fork
- Open a Pull Request
Before opening a Pull Request, make sure your branch is up-to-date with the latest version of main.
This helps prevent merge conflicts and ensures your changes work with the current codebase.
git checkout main
git pull upstream main
git checkout your-branch
git rebase upstream/mainIf you forked the repository, add the original repo as upstream:
git remote add upstream https://github.com/ReginaldErzoah/Dift.gitPull requests that are significantly behind
mainmay be requested to update before review.
python -m venv .venv
source .venv/Scripts/activate
pip install -r requirements.txt
pip install -e .
pytest
ruff check .The following pull requests may be closed without merge:
- whitespace-only changes
- empty formatting edits
- punctuation-only changes with no value
- unrelated drive-by edits
- automated changes without context
- AI-generated PRs with no verification
- duplicate pull requests
- issue farming / contribution farming
- no-op changes
Please explain:
- What changed
- Why it changed
- How it was tested
Meaningful contributions help make Dift the standard open-source dataset diff tool.