This repository has been archived by the owner on Jun 24, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(docs): implemented contribution guidelines
- Loading branch information
1 parent
ecf8d25
commit 913e7a6
Showing
1 changed file
with
54 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
# Contributing Guidelines | ||
|
||
Thank you for considering contributing to our project! Please follow these guidelines to ensure smooth collaboration. | ||
|
||
## General Guidelines | ||
|
||
### Forking the Repository | ||
|
||
1. Fork the repository. | ||
2. Clone the forked repository to your local machine. | ||
3. Implement your changes. | ||
4. Push your changes to your forked repository. | ||
5. Create a pull request to the main repository. | ||
6. Wait for the pull request to be reviewed and merged by the repository owner. | ||
|
||
## Versioning Specifications and Styles | ||
|
||
### GitHub Issues | ||
|
||
1. Create GitHub issues for each task. | ||
2. Please add detailed descriptions to the issues. | ||
|
||
### Feature Branches | ||
|
||
1. Create feature branches for each task from Trello. | ||
2. Branch naming convention: | ||
- The branch name should start with the GitHub issue number. | ||
- After the issue number, use the issue title in lowercase separated with "-" symbol. | ||
- Example: `13-login-system` for GitHub issue #13 with the title "Login system". | ||
- [Optional things to consider](https://tilburgsciencehub.com/building-blocks/collaborate-and-share-your-work/use-github/naming-git-branches/) | ||
|
||
### Commits | ||
|
||
1. Use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) for all commits. | ||
2. Format: `<type>[optional scope]: <description>` | ||
3. Types: | ||
- `fix`: Bugfixes, code fixes. | ||
- `feat`: Feature implementation. | ||
- `chore`: Code cleanup. | ||
4. Example: `feat(api)!: send an email to the customer when a product is shipped` | ||
- The "!" flag is optional and indicates breaking changes. | ||
|
||
### Pull Requests | ||
|
||
1. Submit your changes via pull requests. | ||
2. Reference the relevant GitHub issue in your pull request. | ||
3. Provide a clear and concise description of your changes. | ||
**NOTE**: The pull request should only be merged after reviewing it by (at least) another team member. If there are no related review comments, then the reviewer should merge the PR. This review step ensures the quality and consistency of the codebase. | ||
|
||
## Variable Naming Conventions | ||
|
||
Follow Pythons and PyQts naming conventions for variable naming. | ||
Resources: | ||
[Official Python Docs](https://www.python.org/dev/peps/pep-0008/#naming-conventions) |