Skip to content
This repository was archived by the owner on Jan 31, 2022. It is now read-only.

Commit 5ed9b91

Browse files
robertmogosPLNech
authored andcommitted
chore: Add PR & issues template
1 parent b41dac3 commit 5ed9b91

File tree

4 files changed

+135
-0
lines changed

4 files changed

+135
-0
lines changed

.github/CONTRIBUTING.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
Contributing Guidelines
2+
--------------------------------------------------
3+
4+
This document provides general guidelines about how to contribute to the project. Keep in mind these important things before you start contributing.
5+
6+
### Asking Questions
7+
8+
We do not use github issues for general library support. We think this questions should be posted on stack overflow using [InstantSearch](http://http://stackoverflow.com/questions/tagged/InstantSearch) tag.
9+
10+
### Reporting issues
11+
12+
* Use [github issues](https://github.com/algolia/InstantSearch/issues) to report a bug.
13+
* Before creating a new issue:
14+
* Make sure you are using the [latest release](https://github.com/algolia/InstantSearch/releases).
15+
* Check if the issue was [already reported or fixed](https://github.com/algolia/InstantSearch/issues?utf8=%E2%9C%93&q=is%3Aissue). Notice that it may not be released yet.
16+
* If you found a match add a brief comment "I have the same problem" or "+1". This helps prioritize the issues addressing the most common and critical first. If possible add additional information to help us reproduce and fix the issue. Please use your best judgement.
17+
* Reporting issues:
18+
* Please include the following information to help maintainers to fix the problem faster:
19+
* Xcode version you are using.
20+
* iOS version you are targeting.
21+
* Full Xcode console output of stack trace or code compilation error.
22+
* Any other additional detail you think it would be useful to understand and solve the problem.
23+
24+
25+
### Pull requests
26+
27+
The easiest way to start contributing is searching open issues by `help wanted` tag. We also add a `difficulty` tag (difficulty: easy, difficulty: moderate, difficulty: hard) in order to give an idea of how complex it can be to implement the feature according maintainers project experience.
28+
29+
* Add test coverage to the feature or fix. We only accept new feature pull requests that have related test coverage. This allows us to keep the library stable as we move forward.
30+
* Remember to document the new feature. We do not accept new feature pull requests without its associated documentation.
31+
* In case of a new feature please update the example project showing the feature.
32+
* Please only one fix or feature per pull request. This will increase the chances your feature will be merged.
33+
34+
35+
###### Suggested git workflow to contribute
36+
37+
1. Fork the InstantSearch repository.
38+
2. Clone your forked project into your developer machine: `git clone [email protected]:<your-github-username>/InstantSearch.git`
39+
3. Add the original project repo as upstream repository in your forked project: `git remote add upstream [email protected]:algolia/InstantSearch.git`
40+
4. Before starting a new feature make sure your forked master branch is synchronized upstream master branch. Considering you do not mere your pull request into master you can run: `git checkout master` and then `git pull upstream master`. Optionally `git push origin master`.
41+
5. Create a new branch. Note that the starting point is the upstream master branch HEAD. `git checkout -b my-feature-name`
42+
6. Stage all your changes `git add .` and commit them `git commit -m "Your commit message"`
43+
7. Make sure your branch is up to date with upstream master, `git pull --rebase upstream master`, resolve conflicts if necessary. This will move your commit to the top of git stack.
44+
8. Squash your commits into one commit. `git rebase -i HEAD~6` considering you did 6 commits.
45+
9. Push your branch into your forked remote repository.
46+
10. Create a new pull request adding any useful comment.
47+
48+
49+
###### Code style and conventions
50+
51+
We try to follow our [swift style guide](https://github.com/algolia/Swift-Style-Guide). Following it is not strictly necessary to contribute and to have a pull request accepted but project maintainers try to follow it. We would love to hear your ideas to improve our code style and conventions. Feel free to contribute.
52+
53+
54+
### Feature proposal
55+
56+
We would love to hear your ideas and make a discussions about it.
57+
58+
* Use github issues to make feature proposals.
59+
* We use `type: feature request` label to mark all [feature request issues](https://github.com/algolia/InstantSearch/labels/type%3A%20feature%20request).
60+
* Before submitting your proposal make sure there is no similar feature request. If you found a match feel free to join the discussion or just add a brief "+1" if you think the feature is worth implementing.
61+
* Be as specific as possible providing a precise explanation of feature request so anyone can understand the problem and the benefits of solving it.
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: Bug report
3+
about: Create a report to help us improve our libraries
4+
5+
---
6+
7+
<!--
8+
Thanks for participating in this project! We will try to answer as soon as possible 🙏
9+
-->
10+
11+
**Describe the bug 🐛**
12+
A clear and concise description of what the bug is.
13+
14+
**To Reproduce 🔍**
15+
Steps to reproduce the behavior:
16+
1. Go to '...'
17+
2. Click on '....'
18+
3. Scroll down to '....'
19+
4. See error
20+
21+
**Expected behavior 💭**
22+
A clear and concise description of what you expected to happen.
23+
24+
**Screenshots 🖥**
25+
If applicable, add screenshots to help explain your problem.
26+
27+
**Environment:**
28+
- OS: [e.g. iOS / windows / mac / android]
29+
- Version [e.g. 22]
30+
31+
**Additional context**
32+
Add any other context about the problem here.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
name: Feature request
3+
about: Suggest an idea for this project
4+
5+
---
6+
7+
<!--
8+
Thanks for participating in this project! We will try to answer as soon as possible 🙏
9+
-->
10+
11+
**Is your feature request related to a problem? Please describe 🙏**
12+
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
13+
14+
**Describe the solution you'd like 🤔**
15+
A clear and concise description of what you want to happen.
16+
17+
**Describe alternatives you've considered ✨**
18+
A clear and concise description of any alternative solutions or features you've considered.
19+
20+
**Additional context**
21+
Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<!--
2+
Thanks for submitting a pull request!
3+
Please provide enough information so that others can review your pull request.
4+
-->
5+
6+
**Summary**
7+
8+
<!--
9+
Explain the **motivation** for making this change.
10+
What existing problem does the pull request solve?
11+
Are there any linked issues?
12+
-->
13+
14+
**Result**
15+
16+
<!--
17+
Demonstrate the code is solid.
18+
Example: The exact commands you ran and their output,
19+
screenshots / videos if the pull request changes UI.
20+
-->
21+

0 commit comments

Comments
 (0)