Merge pull request #2211 from guzzle/github-docs

Improve github issue templates

.github/ISSUE_TEMPLATE.md

@@ -1,27 +1 @@
-| Q            | A
-| ------------ | ---
-| Bug?         | no|yes
-| New Feature? | no|yes
-| Version      | Specific version or SHA of a commit
-
-
-#### Actual Behavior
-
-What is the actual behavior?
-
-
-#### Expected Behavior
-
-What is the behavior you expect?
-
-
-#### Steps to Reproduce
-
-What are the steps to reproduce this bug? Please add code examples,
-screenshots or links to GitHub repositories that reproduce the problem.
-
-
-#### Possible Solutions
-
-If you have already ideas how to solve the issue, add them here.
-(remove this section if not needed)
+Please consider using one of the issue templates (bug report, feature request).

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,18 @@
+---
+name: 🐛 Bug Report
+about: Report errors and problems
+---
+
+**Guzzle version(s) affected**: x.y.z
+
+**Description**  
+<!-- A clear and concise description of the problem. -->
+
+**How to reproduce**  
+<!-- Code and/or config needed to reproduce the problem. -->
+
+**Possible Solution**  
+<!--- Optional: only if you have suggestions on a fix/reason for the bug -->
+
+**Additional context**  
+<!-- Optional: any other context about the problem: log messages, screenshots, etc. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: 🚀 Feature Request
+about: RFC and ideas for new features and improvements
+---
+
+**Description**  
+<!-- A clear and concise description of the new feature. -->
+
+**Example**  
+<!-- A simple example of the new feature in action (include PHP code, YAML config, etc.)
+     If the new feature changes an existing feature, include a simple before/after comparison. -->
+
+**Additional context**
+<!-- Add any other context or screenshots about the feature request here. -->

.github/ISSUE_TEMPLATE/security_issue.md

@@ -0,0 +1,10 @@
+---
+name: ⛔ Security Issue
+about: See the description to report security-related issues
+---
+
+⚠ PLEASE DON'T DISCLOSE SECURITY-RELATED ISSUES PUBLICLY, SEE BELOW.
+
+If you have found a security issue in Guzzle, please send the details to
+security [at] guzzlephp.org  and don't disclose it publicly until we can provide a
+fix for it.

.github/ISSUE_TEMPLATE/support_question.md

@@ -0,0 +1,10 @@
+---
+name: ⛔ Support Question
+about: See https://github.com/guzzle/guzzle/blob/master/.github/SUPPORT.md for questions about using Guzzle and its components
+---
+
+We use GitHub issues only to discuss about Guzzle bugs and new features.
+For this kind of questions about using Guzzle,
+please use any of the support alternatives shown in https://github.com/guzzle/guzzle/blob/master/.github/SUPPORT.md
+
+Thanks!

.github/SUPPORT.md

@@ -0,0 +1,18 @@
+# Support
+
+If you're looking for support for Guzzle, here are a few options:
+
+- [Documentation](http://guzzlephp.org/)
+- [Gitter](https://gitter.im/guzzle/guzzle)
+- [#guzzle](https://php-http.slack.com/messages/CE6UAAKL4/) channel in [PHP-HTTP](http://php-http.org) Slack team
+
+Guzzle is a relatively old project, so chances are you will find
+much about them on Google or Stack Overflow:
+
+- [guzzle](https://stackoverflow.com/questions/tagged/guzzle) tag on Stack Overflow (recommended)
+- [guzzlehttp](https://stackoverflow.com/questions/tagged/guzzlehttp) tag on Stack Overflow
+- [guzzle6](https://stackoverflow.com/questions/tagged/guzzle6) tag on Stack Overflow
+
+
+You can also browse the issue tracker for support requests,
+but we encourage everyone to use the channels above instead.