|
1 |
| -# :eight_spoked_asterisk: :stars: :sparkles: :dizzy: :star2: :star2: :sparkles: :dizzy: :star2: :star2: Contributing :star: :star2: :dizzy: :sparkles: :star: :star2: :dizzy: :sparkles: :stars: :eight_spoked_asterisk: |
| 1 | +# 🌟 Contributing |
2 | 2 |
|
3 |
| -So, you want to contribute to this project! That's awesome. However, before |
4 |
| -doing so, please read the following simple steps how to contribute. This will |
5 |
| -make the life easier and will avoid wasting time on things which are not |
6 |
| -requested. :sparkles: |
| 3 | +Want to contribute to this project? Great! Please read these quick steps to streamline the process and avoid unnecessary tasks. ✨ |
7 | 4 |
|
8 |
| -## Discuss the changes before doing them |
9 |
| - - First of all, open an issue in the repository, using the [bug tracker][1], |
10 |
| - describing the contribution you would like to make, the bug you found or any |
11 |
| - other ideas you have. This will help us to get you started on the right |
12 |
| - foot. |
| 5 | +## 💬 Discuss Changes |
| 6 | +Start by opening an issue in the repository using the [bug tracker][1]. Describe your proposed contribution or the bug you've found. If relevant, include platform info and screenshots. 🖼️ |
13 | 7 |
|
14 |
| - - If it makes sense, add the platform and software information (e.g. operating |
15 |
| - system, Node.JS version etc.), screenshots (so we can see what you are |
16 |
| - seeing). |
| 8 | +Wait for feedback before proceeding unless the fix is straightforward, like a typo. 📝 |
17 | 9 |
|
18 |
| - - It is recommended to wait for feedback before continuing to next steps. |
19 |
| - However, if the issue is clear (e.g. a typo) and the fix is simple, you can |
20 |
| - continue and fix it. |
| 10 | +## 🔧 Fixing Issues |
21 | 11 |
|
22 |
| -## Fixing issues |
23 |
| - - Fork the project in your account and create a branch with your fix: |
24 |
| - `some-great-feature` or `some-issue-fix`. |
| 12 | +Fork the project and create a branch for your fix, naming it `some-great-feature` or `some-issue-fix`. Commit changes while following the [code style][2]. If the project has tests, add one. ✅ |
25 | 13 |
|
26 |
| - - Commit your changes in that branch, writing the code following the |
27 |
| - [code style][2]. If the project contains tests (generally, the `test` |
28 |
| - directory), you are encouraged to add a test as well. :memo: |
| 14 | +If a `package.json` or `bower.json` exists, add yourself to the `contributors` array; create it if it doesn't. 🙌 |
29 | 15 |
|
30 |
| - - If the project contains a `package.json` or a `bower.json` file add yourself |
31 |
| - in the `contributors` array (or `authors` in the case of `bower.json`; |
32 |
| - if the array does not exist, create it): |
| 16 | +```json |
| 17 | +{ |
| 18 | + "contributors": [ |
| 19 | + "Your Name <your@email.address> (http://your.website)" |
| 20 | + ] |
| 21 | +} |
| 22 | +``` |
33 | 23 |
|
34 |
| - ```json |
35 |
| - { |
36 |
| - "contributors": [ |
37 |
| - "Your Name <and@email.address> (http://your.website)" |
38 |
| - ] |
39 |
| - } |
40 |
| - ``` |
| 24 | +## 📬 Creating a Pull Request |
| 25 | +Open a pull request and reference the initial issue (e.g., *fixes #<your-issue-number>*). Provide a clear title and consider adding visual aids for clarity. 📊 |
41 | 26 |
|
42 |
| -## Creating a pull request |
| 27 | +## ⏳ Wait for Feedback |
| 28 | +Your contributions will be reviewed. If feedback is given, update your branch as needed, and the pull request will auto-update. 🔄 |
43 | 29 |
|
44 |
| - - Open a pull request, and reference the initial issue in the pull request |
45 |
| - message (e.g. *fixes #<your-issue-number>*). Write a good description and |
46 |
| - title, so everybody will know what is fixed/improved. |
| 30 | +## 🎉 Everyone Is Happy! |
| 31 | +Your contributions will be merged, and everyone will appreciate your effort! 😄❤️ |
47 | 32 |
|
48 |
| - - If it makes sense, add screenshots, gifs etc., so it is easier to see what |
49 |
| - is going on. |
| 33 | +Thanks! 🤩 |
50 | 34 |
|
51 |
| -## Wait for feedback |
52 |
| -Before accepting your contributions, we will review them. You may get feedback |
53 |
| -about what should be fixed in your modified code. If so, just keep committing |
54 |
| -in your branch and the pull request will be updated automatically. |
55 |
| - |
56 |
| -## Everyone is happy! |
57 |
| -Finally, your contributions will be merged, and everyone will be happy! :smile: |
58 |
| -Contributions are more than welcome! |
59 |
| - |
60 |
| -Thanks! :sweat_smile: |
61 |
| - |
62 |
| - |
63 |
| - |
64 |
| -[1]: https://github.com/IonicaBizau/powershell/issues |
65 |
| - |
66 |
| -[2]: https://github.com/IonicaBizau/code-style |
| 35 | +[1]: /issues |
| 36 | +[2]: https://github.com/IonicaBizau/code-style |
0 commit comments