Merge pull request #647 from rgoldberg/630-github-templates

Improve GitHub issue templates

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,58 +1,58 @@
 ---
 name: Bug report
-about: Create a report to help us improve
-title: "\U0001F41B [BUG]"
+about: Report a bug
+title: ''
 labels: "\U0001F41B bug"
 assignees: ''
-
 ---
+## Your Environment
 
+mas version:
 
-## Your Environment
+\<replace this text with the output of `mas version`\>
 
-- `mas version`:
-- macOS version (`system_profiler SPSoftwareDataType -detailLevel mini`): 10.1...
+macOS version:
+
+\<replace this text with the output of `sw_vers`\>
 
 ### mas Install Method
 
-- [] `brew install mas` (homebrew-core)
-- [] [mas-cli/tap](https://github.com/mas-cli/homebrew-tap)
-- [] `.pkg` installer from [releases](https://github.com/mas-cli/mas/releases)
-- [] Built from source
-  - Fork/branch: ? (e.g. mas-cli/main)
-  - Xcode version: 10.?
+[] `brew install mas` ([Homebrew core](https://github.com/Homebrew/homebrew-core))
 
-## Describe the Bug
+[] `brew install mas-cli/tap/mas` ([mas Homebrew custom tap](https://github.com/mas-cli/homebrew-tap))
 
-> A clear and concise description of what the bug is.
+[] [mas GitHub Releases](https://github.com/mas-cli/mas/releases)
 
-## To Reproduce
+- URL of installer:
 
-Steps to reproduce the behavior:
+[] Built from source
 
-1. Go to '...'
-1. Click on '....'
-1. Scroll down to '....'
-1. See error
+- git origin URL: \<e.g., GitHub fork URL, <https://github.com/mas-cli/mas>…\>
+- git revision:
+- git tag/branch:
+- Xcode version:
 
-## Expected Behavior
+## Bug Description
 
-> A clear and concise description of what you expected to happen.
+## Steps to Reproduce
 
-## Actual Behavior
+1.
 
-> A clear and concise description of what actually happened.
+## Expected Behavior
 
-## Screenshots, Terminal Output
+## Actual Behavior
 
-> If applicable, add screenshots to help explain your problem.
+## Shell Output, Screenshots…
 
-```bash
-$ mas command
-...
+\<copy & paste shell commands & output below\>
+
+```shell
+$ mas <command> …
+…
 ```
 
+\<attach screenshots only if cannot copy & paste\>
+
 ## Additional Context
 
-> Add any other context about the problem here.
-> Did it work in a previous version?
+\<e.g., did the bug occur in previous mas or macOS versions?>

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,18 @@
 ---
 name: Feature request
-about: Suggest an idea for this project
+about: Request a feature
 title: ''
 labels: "\U0001F195 feature request"
 assignees: ''
-
 ---
+## Problem(s) addressed
+
+## Proposed solution(s)
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+## Alternative solution(s)
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+## Additional context
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+\<e.g., copied & pasted shell commands & output>
 
-**Additional context**
-Add any other context or screenshots about the feature request here.
+\<e.g., screenshots only if cannot copy & paste>