From 501d2cc0f2ced5c670173a6496601f988b8e3716 Mon Sep 17 00:00:00 2001
From: t <28008958+taeh98@users.noreply.github.com>
Date: Sat, 7 Oct 2023 02:13:49 +0100
Subject: [PATCH] chore: added templates etc to enable contributions

---
 .github/ISSUE_TEMPLATE/BUG_REPORT.md       | 174 +++++++++++++++++++++
 .github/ISSUE_TEMPLATE/FEATURE_REQUEST.md  | 110 +++++++++++++
 .github/ISSUE_TEMPLATE/QUESTION_OR_HELP.md | 149 ++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml          |   8 +
 .github/PULL_REQUEST_TEMPLATE.md           | 118 ++++++++++++++
 5 files changed, 559 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/BUG_REPORT.md
 create mode 100644 .github/ISSUE_TEMPLATE/FEATURE_REQUEST.md
 create mode 100644 .github/ISSUE_TEMPLATE/QUESTION_OR_HELP.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/ISSUE_TEMPLATE/BUG_REPORT.md b/.github/ISSUE_TEMPLATE/BUG_REPORT.md
new file mode 100644
index 0000000..ee5a2c5
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/BUG_REPORT.md
@@ -0,0 +1,174 @@
+---
+name: "🐛 Bug Report"
+about: Report a bug in the library.
+title: 'Bug: '
+labels: [ 'bug report' ]
+---
+
+<!--
+Thank you for reporting an issue with this library!
+Please fill out all the information below about the bug you've found.
+Doing so helps us to fix it ASAP 😃
+-->
+
+## ✅ Checklist
+
+- [ ] I have searched
+  through [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  and am satisfied that this bug report is not a duplicate
+- [ ] I have checked that my bug is present
+  in [the latest version of this library](https://www.npmjs.com/package/react-native-dropdown-picker)
+- [ ] I have
+  searched [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  and [this library's docs](https://hossein-zare.github.io/react-native-dropdown-picker-website/docs)
+  and am satisfied that this is indeed a bug rather than simply something I
+  don't know how to do (if so, make a question/help issue instead)
+- [ ] My bug comes from this library and not others, e.g. React Native or
+  another dependency in my project
+- [ ] I understand that each bug should be submitted in its own issue.
+  Therefore, this issue will contain only one bug, and I will submit any
+  different bugs in their own, separate issues
+
+## 🤔 Summary
+
+<!--
+Please give a brief overview of what this bug is, what it does, and when it appears.
+-->
+
+## ⚠️ The problem
+
+### Desired (expected, correct) behaviour
+
+<!--
+Please describe how this library should behave and act.
+This will be the proper behaviour that should be seen, but isn't because of the bug.
+-->
+
+### Actual (unexpected, incorrect) behaviour
+
+<!--
+Please describe how this library actually does act.
+This will be the undesired behaviour present because of the bug.
+-->
+
+### Screenshots/screen recording
+
+<!--
+If possible, please include screenshots and/or screen recordings showing the bug.
+A picture speaks a thousand words.
+-->
+
+### Conditions
+
+<!--
+Please describe the circumstances/conditions when you do and don't see this bug.
+-->
+
+### Code
+
+<!--
+Please copy and paste the relevant code in your project from which this bug arises.
+-->
+
+### Log/error output
+
+<!--
+If your bug produced terminal output showing any errors or logs, please copy and paste it here.
+-->
+
+## 💻 Environment
+
+### react-native-dropdown-picker version
+
+<!--
+Please add the version of this library you were using when you saw this bug.
+-->
+
+### Node and npm versions
+
+<!--
+Please add the versions of Node and npm you were using when you saw this bug.
+-->
+
+### React, React Native, and Expo versions
+
+<!--
+Please add the versions of React, React Native, and Expo (if applicable) you were using when you saw this bug.
+-->
+
+### Package.json contents
+
+<!--
+Please copy and paste the contents of your package.json file here.
+-->
+
+### Platform/s
+
+<!--
+Please include the platform/s on which you've seen this bug.
+E.g. iPhone 15 running iOS 17.0.2
+-->
+
+### JavaScript or TypeScript
+
+<!--
+Is your project where you found the bug written in JavaScript or TypeScript?
+-->
+
+### Class component or function component
+
+<!--
+Is the component using a DropdownPicker where you saw the bug a class component or a function component?
+-->
+
+## 🔁 Reproducing the bug
+
+### Steps To Reproduce
+
+1. Do this
+2. Then this
+3. ....
+4. Bug appears
+
+<!--
+Please describe how you can reproduce this bug.
+It's important to ensure we can reproduce it.
+Without being able to do so, we won't be able to see it.
+We must be able to see it to be able to fix it.
+-->
+
+### Minimal reproducible example
+
+<!--
+Please include a link to a minimal reproducible example of the bug.
+This should be the minimum amount of code required to show the bug.
+Don't include any code or dependencies not needed for it to be present.
+If you found this bug in your project, strip everything else away from it until it is the bare minimum required to demonstrate this bug.
+
+This example might be within:
+- an Expo Snack (https://snack.expo.dev)
+- a CodeSandbox (https://codesandbox.io)
+- a GitHub repo or gist
+
+Here are some tips for providing a minimal example: https://stackoverflow.com/help/mcve
+-->
+
+Link to minimal reproducible example: <example_link_here>
+
+## 🏁 Final details
+
+### Steps to fix
+
+<!--
+Have you taken any steps to try to debug or fix this issue?
+If you have, what have you learnt while doing so? Did anything work?
+What insights and ideas can you give us into how we might fix this bug?
+Feel free to edit this library with patch-package (https://github.com/ds300/patch-package).
+If you can, see if you can debug or fix the issue and let us know what you find out!
+-->
+
+### Additional context/info
+
+<!--
+Please include any other information you think is relevant to this bug report.
+-->
diff --git a/.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md b/.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md
new file mode 100644
index 0000000..f20c527
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md
@@ -0,0 +1,110 @@
+---
+name: "🚀 Feature request"
+about: Request a new feature to be added to this library.
+title: 'Feature request: '
+labels: [ 'feature request' ]
+---
+
+<!--
+Thank you for making a feature request and helping to improve this library!
+Please fill out all the information below about your idea.
+Doing so helps us to assess its usefulness and feasibility and implement it ASAP 😃
+-->
+
+## ✅ Checklist
+
+- [ ] I have searched
+  through [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  and am satisfied that this feature request is not a duplicate
+- [ ] I have searched
+  through [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  and
+  read [this library's docs](https://hossein-zare.github.io/react-native-dropdown-picker-website)
+  and am satisfied that this feature request is not implemented in the most
+  recent version of the library
+- [ ] I understand that each feature request should be submitted in its own
+  issue. Therefore, this issue will contain only one feature request, and I will
+  submit any different feature requests in their own, separate issues
+
+## 🤔 Overview
+
+### Summary
+
+<!--
+Please give a brief overview of what this feature would add and why, to whom, and when it would be useful.
+-->
+
+### User story
+
+<!--
+Please write a user story describing your proposed feature.
+See guidance at: https://www.atlassian.com/agile/project-management/user-stories
+-->
+
+## 💡 Details
+
+### What
+
+<!--
+Please describe what your new feature would do and how it should work.
+What would you like to happen?
+What would it add to this library?
+Please give some examples of how it would be used.
+-->
+
+### Who
+
+<!--
+Please describe who would find your feature useful.
+This will be an end user, e.g. the elderly person who might want a more visible dropdown with which to interact.
+This will likely be an agile persona: https://www.wrike.com/agile-guide/faq/what-are-agile-personas
+-->
+
+### When
+
+<!--
+Please describe the circumstances/conditions when a user would find this feature useful.
+Is your proposed feature specific to a platform? If so, which?
+-->
+
+### Why
+
+<!--
+Please describe why this feature should be implemented.
+Why would it be useful?
+Please provide any other relevant information on the **use case** you have in mind for this feature.
+-->
+
+### How
+
+<!--
+Please describe any ideas you have on how this feature could be implemented.
+How would you change this library to achieve it?
+Considering the architecture of this library and your desired goals for this feature, are there any design choices to think about?
+Have you tried implementing any of this functionality with patch-package (https://www.npmjs.com/package/patch-package)? 
+If so, what did you learn from doing so?
+-->
+
+## 🏁 Final details
+
+### Similar/same functionality elsewhere
+
+<!--
+Do any other libraries implement functionality the same as or similar to that which you're proposing?
+If so, which ones?
+Why would it still be useful for us to implement it as well if they already have something the same or similar?
+-->
+
+### Possible alternatives
+
+<!--
+Have you considered any alternative solutions, approaches, or features?
+Please describe them if so.
+Why is your proposed feature and solution better than these alternatives?
+-->
+
+### Additional context/info
+
+<!--
+Please include any other information you think is relevant to this feature request.
+-->
diff --git a/.github/ISSUE_TEMPLATE/QUESTION_OR_HELP.md b/.github/ISSUE_TEMPLATE/QUESTION_OR_HELP.md
new file mode 100644
index 0000000..454d67b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/QUESTION_OR_HELP.md
@@ -0,0 +1,149 @@
+---
+name: "❓ Question or help"
+about: Ask a question or for help using the library.
+title: 'Question/help: '
+labels: [ 'help needed' ]
+---
+
+<!--
+Thank you for your question and for using library!
+Please fill out all the information below to get help.
+Doing so helps us to assess your problem and help you 😃
+-->
+
+## ✅ Checklist
+
+- [ ] I have searched through
+  the [other issues for this library](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  and am satisfied that my problem is not a duplicate.
+- [ ] I have checked and
+  read [this library's docs](https://hossein-zare.github.io/react-native-dropdown-picker-website)
+  to try and resolve my problem by myself
+- [ ] I have checked and
+  read [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  to try and resolve my problem by myself
+- [ ] I have checked and
+  read [Stack Overflow](https://stackoverflow.com/questions/tagged/react-native-dropdown-picker)
+  to try and resolve my problem by myself
+- [ ] My problem relates to this library and not others, e.g. React Native or
+  another dependency in my project
+- [ ] I understand that each question/problem should be submitted in its own
+  issue. Therefore, this issue will contain only one such problem, and I will
+  submit any different problems in their own, separate issues
+
+### Relevant docs pages
+
+<!--
+Please include links to any docs pages relevant to your question or problem.
+If there is no relevant information, please include links to the docs pages which should provide relevant information and make a PR in the docs repo to add them too.
+-->
+
+### Relevant issues
+
+<!--
+Please include links to any GitHub issues relevant to your question or problem.
+-->
+
+### Relevant Stack Overflow questions
+
+<!--
+Please include links to any Stack Overflow questions relevant to your question or problem.
+-->
+
+## 🤔 Summary
+
+### Overview
+
+<!--
+Please give a brief overview of what you'd like to do and why, to whom, and when it would be useful.
+-->
+
+### User story
+
+<!--
+Please write a user story describing what you'd like to do but can't.
+It will help us to understand why your problem is relevant.
+See guidance at: https://www.atlassian.com/agile/project-management/user-stories
+-->
+
+## ⚠️ The problem
+
+### What I need help with
+
+<!--
+Please describe what your issue is, the question you have, or the help you need.
+Maybe you want to customise a DropDownPicker somehow but don't know how?
+Maybe you're trying to do something and have copied the docs, but it isn't working?
+-->
+
+### Code
+
+<!--
+Please copy and paste any relevant code here.
+This might be part of your project code where you're trying to use this library in a way that isn't working.
+-->
+
+### Log/error output
+
+<!--
+If your bug produced terminal output showing any errors or logs, please copy and paste it here.
+-->
+
+### Screenshots
+
+<!--
+Please include any relevant screenshots or screen recordings here.
+This might be part of your project where you're trying to use this library in a way that isn't working.
+-->
+
+## 💻 Environment
+
+### react-native-dropdown-picker version
+
+<!--
+Please add the version of this library you were using when you saw this bug.
+-->
+
+### Node and npm versions
+
+<!--
+Please add the versions of Node and npm you were using when you saw this bug.
+-->
+
+### React, React Native, and Expo versions
+
+<!--
+Please add the versions of React, React Native, and Expo (if applicable) you were using when you saw this bug.
+-->
+
+### Package.json contents
+
+<!--
+Please copy and paste the contents of your package.json file here.
+-->
+
+### Platform/s
+
+<!--
+Please include the platform/s on which you've seen this bug.
+E.g. iPhone 15 running iOS 17.0.2
+-->
+
+### JavaScript or TypeScript
+
+<!--
+Is your project where you found the bug written in JavaScript or TypeScript?
+-->
+
+### Class component or function component
+
+<!--
+Is the component using a DropdownPicker where you saw the bug a class component or a function component?
+-->
+
+## 🏁 Additional context/info
+
+<!--
+Please include any other information you think is relevant to this problem/question/etc.
+Do you have any ideas or hunches on how to solve your issue? What have you tried already?
+-->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..576316e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+---
+blank_issues_enabled: false
+contact_links:
+  - name: 📃 Documentation Issue
+    url: https://github.com/hossein-zare/react-native-dropdown-picker-website
+    about: >
+      If this library's docs are incorrect or are missing something,
+      please file an issue here.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..d2605c4
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,118 @@
+<!--
+Thank you very much for your contribution!
+We really appreciate your effort to improve this library for everyone.
+Please fill out the rest of the information here.
+It will help us to review, validate, and merge your changes 😃
+-->
+
+## ✅ Checklist
+
+<!--
+Please check the applicable items below. Please write any extra relevant context after an item.
+-->
+
+- [ ] I have
+  followed [the contributing guidance](https://github.com/hossein-zare/react-native-dropdown-picker/blob/dev-5.x/CONTRIBUTING.md).
+- [ ] I have
+  read [this library's docs](https://hossein-zare.github.io/react-native-dropdown-picker-website/docs),
+  and it is still sensible to make these changes
+- [ ] I have
+  read [this library's GitHub issues](https://github.com/hossein-zare/react-native-dropdown-picker/issues),
+  and it is still sensible to make these changes
+- [ ] 
+  I [made an issue](https://github.com/hossein-zare/react-native-dropdown-picker/issues)
+  for the new feature/bug fix/etc this PR implements
+- [ ] 
+  This [PR is linked to its relevant issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)
+- [ ] I
+  have [tested my changes and this library as a whole with npm pack](https://dev.to/scooperdev/use-npm-pack-to-test-your-packages-locally-486e),
+  and everything works
+- [ ] My changes pass all the
+  repo's [CI/status checks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks),
+  including the Prettier and ESLint checks
+- [ ] I
+  have [squashed all my changes into one commit](https://www.geeksforgeeks.org/git-squash/)
+- [ ] My single commit message conforms
+  to [the Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/#summary)
+- [ ] I added/changed automated tests to ensure my feature works correctly and
+  continues to do so
+- [ ] I
+  have [kept my changes up-to-date with those in the `dev-5.x` (default) branch](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/keeping-your-pull-request-in-sync-with-the-base-branch)
+- [ ] My changes do not require changing this library's docs: they are
+  up-to-date and comprehensive even with my changes
+- [ ] My changes require this library's docs to be updated and/or completed to
+  include all relevant and up-to-date information
+- [ ] I have made a separate PR
+  in [the docs repo](https://github.com/hossein-zare/react-native-dropdown-picker-website)
+  to update them in light of this PR
+- [ ] I understand that each atomic change (e.g. fixing one bug or adding one
+  feature) should be submitted in its own PR. Therefore, this PR will contain
+  only one such atomic change, and I will submit any different changes in their
+  own, separate PRs
+
+## 👀 Relevant issue(s)
+
+<!--
+Fill out the issue/s your PR pertains to below.
+-->
+
+- Fixes bug #<bug_GitHub_issue_number_goes_here>
+- Implements feature request #<feature_request_GitHub_issue_number_goes_here>
+- Fixes bug #<bug_GitHub_issue_number_goes_here>
+
+## 🚀️ Changes made
+
+### What
+
+<!--
+Please give a brief overview of the changes this PR makes.
+-->
+
+### Why
+
+<!--
+Please describe the motivation for this PR. Why are its changes needed?
+-->
+
+### How
+
+<!--
+How did you create the changes in this PR?
+What design decisions did you make, and why?
+Why did you create the changes in the manner you did, as opposed to alternative approaches?
+-->
+
+### Tests
+
+<!--
+Please describe how you tested these changes and this library as a whole after making them.
+Please say whether you added any automated tests to check your changes work.
+Please describe how a reviewer could reproduce your tests.
+This will be especially relevant if you didn't add any automated tests.
+If possible, please also provide terminal output and/or screenshots demonstrating your tests and/or feature working correctly.
+Please describe the outcome of your tests. Does everything work? Do you need help fixing an issue?
+-->
+
+## 🏁 Final details
+
+### Relevant docs pages
+
+<!--
+Please include a link to any page/s on the docs that are relevant.
+If none, type "N/A" and describe whether information should be added to the docs and why.
+-->
+
+### Help required
+
+<!--
+Please include any help you need. We'll be happy to provide it 😃
+Maybe you need help to understand how certain parts of this library work?
+Maybe you need help to fix a particular issue you're struggling to solve alone?
+If you don't need any, say "N/A".
+-->
+
+### Additional context/info
+
+<!--
+Please include any other information you think is relevant to this PR.
+-->