Skip to content

Commit 93f076d

Browse files
authored
Add contributing guidelines to CONTRIBUTING.md
This document provides guidelines for contributing to the project, including communication style, issue handling, and pull request procedures.
1 parent a970bfb commit 93f076d

1 file changed

Lines changed: 90 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
# Contributing to Oss Communities
2+
3+
Contributions are always welcome, no matter how large or small. Before contributing, please read the [Code of Conduct](https://github.com/OpenSource-Communities/.github/blob/main/CODE_OF_CONDUCT.md) and follow the directions in this guide.
4+
5+
## Recommended Communication Style
6+
7+
1. Always include screenshots for visual changes.
8+
2. Always provide a detailed description in the pull request. Leave nothing ambiguous for the reviewer(s).
9+
3. Always review your code first. Be sure to run the project locally and test it before asking for a review.
10+
4. Always communicate in the GitHub repository. Whether it is in the issue or the pull request, keeping the lines of communication open and visible to everyone on the team helps everyone around you.
11+
12+
## Issues
13+
14+
- When you contribute to the project for the first time, please consider checking the [bug](https://github.com/OpenSource-Communities/intro/issues?q=is%3Aissue+is%3Aopen+label%3A%22%F0%9F%90%9B+bug%22), [good first issue](https://github.com/OpenSource-Communities/intro/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22), or [beginners only](https://github.com/OpenSource-Communities/intro/issues?q=is%3Aissue+is%3Aopen+label%3A%22beginners+only%22) labels.
15+
16+
- If you wish to work on an open issue, please comment, and it will be assigned to you. <br> If an issue is not assigned, it is assumed to be available for anyone to work on. Do not work on an issue **before** it's assigned to you to avoid conflicts.
17+
18+
- If you create an issue, our maintainers still need to triage the issue before you can work on it. If you wish to work on the issue you submitted, please inform and tag the maintainers in the comment.
19+
20+
You can always ask for help in our [Community](https://github.com/OpenSource-Communities/intro/discussions) if you get stuck while working on your changes or need clarification.
21+
22+
## Pull Requests (PRs)
23+
24+
We actively welcome your PRs. However, before working on changes, you must ensure that **you are assigned** to an existing issue and **link your work to the issue in your PR template** using a keyword, like `closes #123`.
25+
26+
### Before Submitting a PR Template
27+
28+
1. Ensure that your changes are made in a new branch.
29+
30+
2. Run and check your changes locally. Ensure that everything works as it should.
31+
32+
### Submitting a PR Template
33+
34+
1. Ensure that you address one issue in one PR. <br> If you work on multiple issues, work on them separately and create one PR to address each issue.
35+
36+
2. Complete the PR template. Make sure you **fill in all sections** and that you have:
37+
38+
- **A valid title**. The PR title must begin with `feat:`, `fix:`, or anything related to your changes.
39+
- **A related issue**. [Link the issue number](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) that you worked on and add a keyword of "Closes", "Fixes", or "Resolves" in front of it. For example: Closes #123, Fixes #234, etc.
40+
41+
3. Do NOT delete any section of the PR template. <br> If a section is irrelevant to your changes, please explain or respond with "N/A".
42+
43+
### After Submitting a PR Template
44+
45+
1. Ensure that all checks are passed. <br> If you see any GitHub action bots or checks that failed after you submit your PR template, you need to read each one and understand why it failed. Then, you must address and fix it until all of them pass.
46+
47+
2. Do NOT DM maintainers or tag them in the comments to review your PR. <br> Maintainers are always notified whenever there is an incoming PR. If you haven't received a review within a week, please tag them in the PR comments to ask for an estimated review time.
48+
49+
3. Keep your branch up to date while waiting for review and resolve any merge conflicts in your terminal.
50+
51+
4. Respond to and address the reviewer's feedback.
52+
53+
### ⚠️ A PR will be marked as invalid and may be closed if:
54+
55+
- The issue is not assigned to the contributor who opened the PR.
56+
- No issue is linked to the PR.
57+
- The PR template is incomplete, or any section in the template is deleted.
58+
- Changes are made directly in the default (`main`) branch.
59+
60+
## Getting Started
61+
62+
### Setup the Project Locally
63+
64+
1. [Fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) the repository to your own GitHub account.
65+
2. [Clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) the forked repository to your local machine.
66+
3. Navigate to and open the project in your code editor.
67+
4. Create a new branch to work on your changes. Do NOT work directly on the `main` branch.
68+
69+
```bash
70+
git checkout -b YOUR-BRANCH-NAME
71+
```
72+
73+
Replace "YOUR-BRANCH-NAME" with a descriptive name for your branch — for example, `feat/add-submit-button`.
74+
75+
5. Install the dependencies and run the project.
76+
77+
### Local Development
78+
79+
> [!NOTE]
80+
> Always test the changes locally to see if they're working.
81+
82+
1. **Install the dependencies and run the project locally**.
83+
84+
2. **Make and test changes**.
85+
86+
With the local server running, you can make changes to the files and immediately see the results in your browser. Test your changes thoroughly.
87+
88+
3. **Stop the server**.
89+
90+
After completing and testing the changes, you can stop the local server by pressing `Ctrl + C` in the terminal.

0 commit comments

Comments
 (0)