mirror of
https://github.com/onestardao/WFGY.git
synced 2026-04-28 03:29:51 +00:00
Update CONTRIBUTING.md
This commit is contained in:
parent
a1d2dbf523
commit
897f310504
1 changed files with 73 additions and 0 deletions
|
|
@ -1,3 +1,5 @@
|
|||
|
||||
|
||||
# Contributing to WFGY
|
||||
|
||||
Thank you for your interest in contributing to **WFGY**! To make contributions smooth and effective, please follow this guide.
|
||||
|
|
@ -21,3 +23,74 @@ source venv/bin/activate
|
|||
# Windows PowerShell:
|
||||
# .\venv\Scripts\Activate.ps1
|
||||
pip install -r requirements.txt
|
||||
````
|
||||
|
||||
* Create a new branch for your work:
|
||||
|
||||
```bash
|
||||
git checkout -b feature/short-description-of-feature
|
||||
```
|
||||
|
||||
## 3. Development & Testing
|
||||
|
||||
* **Code Style**:
|
||||
|
||||
* Use `black`: `black .`
|
||||
* Use `isort`: `isort .`
|
||||
* Use `pre-commit` if set up: `pre-commit run --all-files`
|
||||
* **Running Tests**:
|
||||
|
||||
* Run `pytest tests/` (or the specific command used by this project). Ensure all tests pass locally.
|
||||
* If you add new functionality or fix a bug, include appropriate tests.
|
||||
* **Dependencies**:
|
||||
|
||||
* If you introduce new dependencies, add them to `requirements.txt` or the appropriate config file.
|
||||
|
||||
## 4. Submitting a Pull Request
|
||||
|
||||
* **Title Format**:
|
||||
|
||||
* Example: `Add: Brief description of feature` or `Fix: Brief description of bug fix`.
|
||||
* **Description**: In the PR description, include:
|
||||
|
||||
* Motivation and summary of changes.
|
||||
* Testing steps and results.
|
||||
* Related issue number, using “Closes #<issue-number>” if applicable.
|
||||
* **Target Branch**:
|
||||
|
||||
* Set target branch to `main` (or another branch if the project follows a different workflow).
|
||||
* **Review Process**:
|
||||
|
||||
* Maintainers will review your PR, may request changes; please be patient and address feedback.
|
||||
* **Clean Commits**:
|
||||
|
||||
* Squash or rebase commits if needed to keep history clear, according to project preference.
|
||||
|
||||
## 5. Documentation
|
||||
|
||||
* If your changes require updates to documentation (README, examples, API reference), please include those updates in the same PR.
|
||||
* If applicable, update version/changelog files as per release workflow.
|
||||
|
||||
## 6. Release Process (for Maintainers)
|
||||
|
||||
* Typically maintainers handle tagging and releasing new versions.
|
||||
* If you wish to propose a release candidate, open an issue with title `[Release Candidate]` and summary of changes.
|
||||
* Follow semantic versioning (if used) and update changelog accordingly.
|
||||
|
||||
## 7. Communication Channels
|
||||
|
||||
* **Telegram**: Telegram user @PSBigBig (for quick chats).
|
||||
* **GitHub Discussions**: [https://github.com/onestardao/WFGY/discussions](https://github.com/onestardao/WFGY/discussions) (if enabled).
|
||||
* **Email**: [hello@onestardao.com](mailto:hello@onestardao.com) (for longer-form discussion or private matters).
|
||||
* Please be respectful and follow the Code of Conduct when interacting.
|
||||
|
||||
## 8. Large Changes
|
||||
|
||||
* For major or breaking changes (e.g., architecture refactor, breaking API), please open an issue first to discuss design and implications.
|
||||
* Label your draft PR appropriately (e.g., “WIP”, “RFC”).
|
||||
|
||||
## 9. Acknowledgements
|
||||
|
||||
* Contributions of any kind—code, documentation, examples, bug reports, suggestions—are welcome!
|
||||
* Thank you for helping improve WFGY.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue