Pulling from upstream

.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -0,0 +1,48 @@
+name: Reproducible Bug Report
+description: If you’re sure it’s reproducible and not just your machine, submit an issue so we can investigate
+body:
+  - type: checkboxes
+    attributes:
+      label: Verification
+      description: Please verify that you’ve followed these steps
+      options:
+        - label: I understand that [if I ignore these instructions, my issue may be closed without review](https://github.com/Homebrew/homebrew-cask/blob/master/doc/faq/closing_issues_without_review.md).
+          required: true
+        - label: I have retried my command with `--force`.
+          required: false
+        - label: I ran `brew update-reset && brew update` and retried my command.
+          required: false
+        - label: I ran `brew doctor`, fixed as many issues as possible and retried my command.
+          required: false
+        - label: I have checked the instructions for [reporting bugs](https://github.com/Homebrew/homebrew-cask#reporting-bugs).
+          required: true
+        - label: I made doubly sure this is not a [checksum does not match / SHA256 mismatch](https://docs.brew.sh/Common-Issues#cask---checksum-does-not-match) error (do not open an issue before trying to open a PR to fix first).
+          required: true
+  - type: textarea
+    attributes:
+      label: Description of issue
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: Command that failed
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Output of command with `--verbose --debug`
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Output of `brew doctor` and `brew config`
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Output of `brew tap`
+      render: shell
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,15 @@
+blank_issues_enabled: false
+
+contact_links:
+  - name: Get help in GitHub Discussions
+    url: https://github.com/orgs/Homebrew/discussions
+    about: Have a question? Not sure if your issue affects everyone reproducibly? The quickest way to get help is on Homebrew's GitHub Discussions!
+  - name: New issue on Homebrew/brew
+    url: https://github.com/Homebrew/brew/issues/new/choose
+    about: Having a `brew` problem that's not from a `brew install` or `brew upgrade` of a single cask? Report it to Homebrew/brew (the Homebrew package manager)
+  - name: New issue on Homebrew/homebrew-core
+    url: https://github.com/Homebrew/homebrew-core/issues/new/choose
+    about: Having a Homebrew formula problem? Report it to Homebrew/homebrew-core (the formula tap/repository)
+  - name: Ideas for a new feature
+    url: https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request
+    about: If you have an idea for a new feature, here's how to add it to Homebrew

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,27 +1,19 @@
-<!-- If there’s a checkbox you can’t complete for any reason, that's okay, just explain in detail why you weren’t able to do so. -->
+**Important:** *Do not tick a checkbox if you haven’t performed its action.* Honesty is indispensable for a smooth review process.
 
-After making all changes to the cask:
+_In the following questions `<cask>` is the token of the cask you're submitting._
 
-- [ ] `brew cask audit --download {{cask_file}}` is error-free.
-- [ ] `brew cask style --fix {{cask_file}}` reports no offenses.
-- [ ] The commit message includes the cask’s name and version.
+After making any changes to a cask, existing or new, verify:
 
-Additionally, if **updating a cask**:
+- [ ] The submission is for [a stable version](https://docs.brew.sh/Acceptable-Casks#stable-versions) or [documented exception](https://docs.brew.sh/Acceptable-Casks#but-there-is-no-stable-version).
+- [ ] `brew audit --cask --online <cask>` is error-free.
+- [ ] `brew style --fix <cask>` reports no offenses.
 
-- [ ] `sha256` changed but `version` stayed the same ([what is this?][version-checksum]).  
-      I’m providing public confirmation below.
+Additionally, **if adding a new cask**:
 
-Additionally, if **adding a new cask**:
+- [ ] Named the cask according to the [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference).
+- [ ] Checked the cask was not [already refused](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests) (add your cask's name to the end of the search field).
+- [ ] `brew audit --cask --new <cask>` worked successfully.
+- [ ] `HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask <cask>` worked successfully.
+- [ ] `brew uninstall --cask <cask>` worked successfully.
 
-- [ ] Named the cask according to the [token reference].
-- [ ] `brew cask install {{cask_file}}` worked successfully.
-- [ ] `brew cask uninstall {{cask_file}}` worked successfully.
-- [ ] Checked there are no [open pull requests] for the same cask.
-- [ ] Checked the cask was not already refused in [closed issues].
-- [ ] Checked the cask is submitted to [the correct repo].
-
-[token reference]: https://github.com/caskroom/homebrew-cask/blob/master/doc/cask_language_reference/token_reference.md
-[open pull requests]: https://github.com/caskroom/homebrew-cask/pulls
-[closed issues]: https://github.com/caskroom/homebrew-cask/issues?q=is%3Aissue+is%3Aclosed
-[the correct repo]: https://github.com/caskroom/homebrew-cask/blob/master/doc/development/adding_a_cask.md#finding-a-home-for-your-cask
-[version-checksum]: https://github.com/caskroom/homebrew-cask/blob/master/doc/cask_language_reference/stanzas/sha256.md#updating-the-sha256
+---