Skip to content

Commit f2bcbc4

Browse files
authored
docs(readme): update contributions section
1 parent 2f70052 commit f2bcbc4

File tree

1 file changed

+18
-3
lines changed

1 file changed

+18
-3
lines changed

README.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,12 +72,27 @@ The issues for this add-on are tracked on its github.com page. All bug reports a
7272

7373
## Contributions
7474

75-
Contributions are welcome, but there are no guarantees that they are accepted as such.
75+
Contributions are welcome. There are two primary ways you can contribute: by reporting issues or by submitting code changes through pull requests. To ensure a smooth and effective process for everyone, please follow the guidelines below for the type of contribution you are making.
7676

77-
As first step, please refer to our [Development Conventions](https://github.com/FlowingCode/DevelopmentConventions) page to find information about Conventional Commits & Code Style requirements.
77+
#### 1. Reporting Bugs and Requesting Features
7878

79-
Then, follow these steps for creating a contribution:
79+
Creating an issue is a highly valuable contribution. If you've found a bug or have an idea for a new feature, this is the place to start.
80+
81+
* Before creating an issue, please check the existing issues to see if your topic is already being discussed.
82+
* If not, create a new issue, choosing the right option: "Bug Report" or "Feature Request". Try to keep the scope minimal but as detailed as possible.
83+
84+
> **A Note on Bug Reports**
85+
>
86+
> Please complete all the requested fields to the best of your ability. Each piece of information, like the environment versions and a clear description, helps us understand the context of the issue.
87+
>
88+
> While all details are important, the **[minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example)** is the most critical part of your report. It's essential because it removes ambiguity and allows our team to observe the problem firsthand, exactly as you are experiencing it.
89+
90+
#### 2. Contributing Code via Pull Requests
8091

92+
As a first step, please refer to our [Development Conventions](https://github.com/FlowingCode/DevelopmentConventions) page to find information about Conventional Commits & Code Style requirements.
93+
94+
Then, follow these steps for creating a contribution:
95+
8196
- Fork this project.
8297
- Create an issue to this project about the contribution (bug or feature) if there is no such issue about it already. Try to keep the scope minimal.
8398
- Develop and test the fix or functionality carefully. Only include minimum amount of code needed to fix the issue.

0 commit comments

Comments
 (0)