chore(github): issue template cleanup (#3056)

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,58 +1,73 @@
 ---
-name: Bug Report
-about: Template to report bugs
+name: 🐛 Bug Report
+about: Report something not working
 title: 'bug: '
 labels: ''
 assignees: ''
 
 ---
 
-# Bug Report
+## Bug Report
 
-## Capacitor Version
-<!-- Provide the version of Capacitor and related installed dependencies. You can use the command `npx capacitor doctor` or `npx cap doctor` for the output from the root directory of your project. -->
-
-`npx cap doctor` output:
+### Capacitor Version
+<!--
+Paste the output from the `npx cap doctor` command into the code block below. This will provide the versions of Capacitor packages and related dependencies.
+-->
 
+```
+PASTE OUTPUT HERE
+```
 
-## Affected Platform(s)
-<!-- Leave these checkboxes EMPTY until after the issue is created. Once the issue is created, check one or more boxes for the platform(s) this bug affects. -->
+### Platform(s)
+<!--
+List the platforms that this bug affects.
+-->
 
-- [ ] Android
-- [ ] iOS
-- [ ] Electron
-- [ ] Web
 
-## Current Behavior
-<!-- Describe how the bug manifests. Be specific. -->
 
+### Current Behavior
+<!--
+Describe how the bug manifests. Be specific.
+-->
 
-## Expected Behavior
-<!-- Describe what the behavior would be without the bug. -->
 
-## Sample Code or Sample Application Repo
 
-<!-- 
+### Expected Behavior
+<!--
+Describe what the behavior should be.
+-->
 
-NOTE: Issues with sample projects are prioritized higher than ones without because they are easier to reproduce and fix.
 
-If you are able to illustrate the bug or feature request with an example, please provide sample code snippets or a sample application via a public GitHub or Bitbucket repo. 
 
+### Example Code or Repo
+<!--
+If you are able to illustrate the bug with an example, please provide sample code snippets or a sample application using a public repo (preferred).
 -->
 
-## Reproduction Steps
 
-<!--  Please explain the steps required to duplicate the issue, especially if you are able to provide a sample application. -->
 
-## Other Technical Details
+### Code Reproduction
+<!--
+To isolate the cause of the problem, we ask you to provide a minimal sample application that demonstrates the issue.
+For full instructions, see: https://github.com/ionic-team/capacitor/blob/master/CONTRIBUTING.md#creating-a-code-reproduction
+-->
+
+
 
-<!-- Please provide the following information with your request, and any other relevant technical details (versions of IDEs, local environment info, plugin information or links, etc). -->
+### Other Technical Details
+<!--
+Please provide the following information with your request and any other relevant technical details (versions of IDEs, local environment info, plugin information or links, etc).
+-->
 
 `npm --version` output:
 
 `node --version` output:
 
 `pod --version` output (iOS issues only):
 
-## Other Information
-<!-- List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc. -->
+### Additional Context
+<!--
+List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc.
+-->
+
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Open a discussion
+    url: https://github.com/ionic-team/capacitor/discussions
+    about: Ask questions and discuss with other community members

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,33 +1,41 @@
 ---
-name: Feature Request
-about: Request a feature addition or change to Capacitor.
+name: 🙋 Feature Request
+about: Request a feature or change
 title: 'feat: '
 labels: ''
 assignees: ''
 
 ---
 
-# Feature Request
+## Feature Request
 
-## Describe the Feature Request
-<!-- A clear and concise description of what the feature request is. Please include if your feature request is related to a problem. -->
+### Description
+<!--
+Describe the feature request. If your feature request is related to a problem, be sure to describe that as well.
+-->
 
-## Platform Support Requested
-<!-- Leave these checkboxes EMPTY until after the issue is created. Once the issue is created, check one or more boxes for the platform(s) where this feature should be added. Note that certain features may not be supported on some platforms (i.e. no web API is available, etc.) -->
 
-- [ ] Android
-- [ ] iOS
-- [ ] Electron
-- [ ] Web
 
-## Describe Preferred Solution
-<!-- A clear and concise description of what you want to happen. -->
+### Platform(s)
+<!--
+List the platforms for which this feature should be added.
+-->
 
-## Describe Alternatives
-<!-- A clear and concise description of any alternative solutions or features you've considered. -->
 
-## Related Code
-<!-- If you are able to illustrate the feature request with an example, please provide a sample application via an online code collaborator such as [StackBlitz](https://stackblitz.com), or [GitHub](https://github.com). -->
 
-## Additional Context
-<!-- List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to add, use case, Stack Overflow links, forum links, screenshots, OS if applicable, etc. -->
+### Preferred Solution
+<!-- Describe the solution you would prefer. -->
+
+
+
+### Alternatives
+<!-- Describe alternative solutions or features you've considered, if any. -->
+
+
+
+### Additional Context
+<!--
+List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc.
+-->
+
+

.github/CONTRIBUTING.md → CONTRIBUTING.md

@@ -8,19 +8,35 @@ Before working on Capacitor, it's important to understand the philosophy behind
 
 Please read [@maxlynch](http://twitter.com/maxlynch)'s essay [How Capacitor Works](https://tinyletter.com/ionic-max/letters/how-capacitor-works) for a deep dive into the project and its goals.
 
-## Consult with the team
+## Creating a Code Reproduction
+
+To isolate the cause of the problem, we ask you to provide a minimal sample application that demonstrates the issue. Without a reliable code reproduction, it is unlikely we will be able to resolve the issue, leading to it being closed.
+
+To create a code reproduction:
+
+* Create a new application using `npx @capacitor/cli create` (or `ionic start --capacitor`).
+* Add the minimum amount of code necessary to recreate the issue you're experiencing.
+* Push the code reproduction to a public GitHub repository and include a link when you create a bug report.
+* Be sure to include steps to reproduce the issue.
+
+## Developing Capacitor
+
+1. Check out this repository.
+2. Read and follow [`example/README.md`](../example/README.md)
+
+### Consult with the team
 
 For any large changes, make sure you've consulted with the team first. One way to do this would be to create a draft PR for discussion, or bringing up the discussion in the Capacitor slack.
 
-## About Third Party Libraries
+### About Third Party Libraries
 
 To achieve Capacitor's goal of being stable and easy to upgrade, we would like to avoid unnecessary third party libraries as much as possible. Before embarking on Capacitor contributions, make sure you aren't planning on introducing third party libraries without consulting with the team first.
 
 On native, that means avoid adding any new Cocoapod or Gradle dependencies without explicit approval. If you just need a small bit of functionality from that library, consider adding an implementation to the codebase directly.
 
 On web, this means do not add any third party libraries such as Firebase or Lodash. Strive for implementations that use pure Web APIs even if it means more work.
 
-## Directory Structure
+### Directory Structure
 
 The `ionic-team/capacitor` repo is a monorepo containing all of the standard Capacitor components. The current directory structure looks like this:
 
@@ -34,29 +50,15 @@ The `ionic-team/capacitor` repo is a monorepo containing all of the standard Cap
 * `example`: Example project for development
 * `e2e`: An end-to-end testing app
 * `plugin-template`: The default plugin template when creating a new plugin
-* `scripts`: deploy and task scripts
+* `scripts`: publish and task scripts
 * `site`: Website and documentation
 
-## Developing Capacitor
-
-1. Check out this repository.
-2. Read and follow [`example/README.md`](../example/README.md)
-
-## Deploying Capacitor (requires commit privileges)
+## Publishing Capacitor
 
-The `publish` npm task runs lerna to update and publish JS dependencies, and then uses that version number to deploy the Android and iOS runtimes.
+Capacitor packages are published together with a fixed version using [Lerna](https://github.com/lerna/lerna).
 
-Additionally, it updates the master branch of the [capacitor-starter](https://github.com/ionic-team/capacitor-starter) mirror, which contains an exported starter project for easy project creation, based on the code in the `starter` folder in this monorepo.
+To publish Capacitor, run the following:
 
-Before deploying, you must set the following environment variables:
-
- - `BINTRAY_USER`: your username from [bintray.com](http://bintray.com)
- - `BINTRAY_KEY`: your API key from Bintray, found in the "Edit Profile" section of the site.
-
-Finally, to deploy Capacitor, in the root of the project run
-
 ```bash
 npm run publish
 ```
-
-Note: if you don't have any JS updates that cause lerna to increment the version, just increment it yourself in `lerna.json` and you're golden.

README.md

@@ -69,6 +69,6 @@ No, you do not need to use Ionic Framework with Capacitor. Without the Ionic Fra
 
 ## Contributing
 
-See [`CONTRIBUTING.md`](.github/CONTRIBUTING.md) 💖
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) 💖
 
 To help with the Capacitor website or documentation, [see here](site/CONTRIBUTING.md).