|
1 | | - |
2 | | - |
3 | | -Thank you for Contributing |
| 1 | +Contributing Guide |
4 | 2 | === |
5 | 3 |
|
6 | | -We want to make it as easy as possible to contribute changes. |
| 4 | +Issues & Feature Requests |
| 5 | +--- |
7 | 6 |
|
8 | | -Follow the requirements below for __[Creating Issues](https://github.com/sfccdevops/sfcc-cli/issues/new)__ and __[Pull Requests](https://github.com/sfccdevops/sfcc-cli/pull/new)__, to keep everything simple for everyone :) |
| 7 | +[](https://github.com/sfccdevops/sfcc-cli/issues/new/choose) |
9 | 8 |
|
10 | | -<img src="https://octodex.github.com/images/dinotocat.png" width="400" /> |
| 9 | +### Bug Fix |
11 | 10 |
|
12 | | -Creating an Issue |
13 | | ---- |
| 11 | +> We're sorry things are not working as expected, and want to get things fixed ASAP. In order to help us do that, we need a few things from you. |
| 12 | +
|
| 13 | +1. Create a [New Issue](https://github.com/sfccdevops/sfcc-cli/issues/new/choose) |
| 14 | +2. Enter a Short but Descriptive Title for the Issue |
| 15 | +3. Use the Template Provided and fill in as much as you can, if something does not apply, enter `N/A` |
| 16 | +4. Look for the `Labels` section, and select `Bug Report` from the drop down menu |
| 17 | +5. Click `Submit new issue` button |
| 18 | + |
| 19 | +### Feature Request |
14 | 20 |
|
15 | | -Use the Prepopulated Template that we provide. Issues reported that do not use the template will be rejected. |
| 21 | +> Got an idea for a new feature? We'd love to hear it! In order to get this knocked out, we will need a few things from you. |
16 | 22 |
|
| 23 | +1. Create a [New Issue](https://github.com/sfccdevops/sfcc-cli/issues/new/choose) |
| 24 | +2. Enter a Short but Descriptive Title for the Feature Request |
| 25 | +3. Use the Template Provided and fill in as much as you can, if something does not apply, enter `N/A` ( you can delete the `Steps to Duplicate:` section as that does not apply ) |
| 26 | +4. Look for the `Labels` section, and select `Feature Request` from the drop down menu |
| 27 | +5. Click `Submit new issue` button |
17 | 28 |
|
18 | | -Creating a Pull Request |
| 29 | +Pull Requests |
19 | 30 | --- |
20 | 31 |
|
21 | | -Before you can submit a PR, you will need to: |
| 32 | +[](https://github.com/sfccdevops/sfcc-cli/compare) |
| 33 | + |
| 34 | +### Bug Fix |
| 35 | + |
| 36 | +> Each Bug Fix reported on GitHub should have its own `fix/*` branch. The branch name should be formatted `fix/###-issue-name` where `###` is the GitHub Issue Number, and `issue-name` is a 1-3 word summary of the issue. |
| 37 | +
|
| 38 | +1. Checkout latest `develop` branch |
| 39 | +2. Pull down the latest changes via `git pull` |
| 40 | +3. Create a new branch with the structure `fix/*`, e.g. `fix/123-broken-form` |
| 41 | +4. When you are ready to submit your code, submit a new Pull Request that merges your code into `develop` |
| 42 | +5. Tag your new Pull Request with `Ready for Code Review` |
| 43 | + |
| 44 | +### Feature Request |
22 | 45 |
|
23 | | -1. Make a New Branch off of `staging` ( ideally you will name your branch for the issue you are fixing, e,g, `issue-3-fixing-logger` ) |
24 | | -2. Commit & Push your New Branch, with a comment like `Fixes #3` to auto trigger a status change for that issue |
25 | | -3. Make your Pull Request into the `develop` |
26 | | -4. Set `Reviewers` and `Assignees` to `Peter Schmalfeldt` ( or other project administrator ) |
27 | | -5. Choose an appropriate label from the `Labels` |
| 46 | +> Each New Feature should reside in its own `feature/` branch. The branch name should be formatted `feature/###-feature-name` where `###` is the GitHub Issue Number, and `feature-name` is a 1-3 word summary of the feature. |
28 | 47 |
|
29 | | -Now you can submit a new PR using the Prepopulated Template that we provide. PR's submitted that do not use the template will be rejected. |
| 48 | +1. Checkout latest `develop` branch |
| 49 | +2. Pull down the latest changes via `git pull` |
| 50 | +3. Create a new branch with the structure `feature/*`, e.g. `feature/123-mobile-header` |
| 51 | +4. When you are ready to submit your code, submit a new Pull Request that merges your code into `develop` |
| 52 | +5. Tag your new Pull Request with `Ready for Code Review` |
0 commit comments