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

.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
 
-**Is your feature request related to a problem? Please describe.**
+## Proposed solution(s)
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
 
-**Describe the solution you'd like**
+## Alternative solution(s)
-A clear and concise description of what you want to happen.
 
-**Describe alternatives you've considered**
+## Additional context
-A clear and concise description of any alternative solutions or features you've considered.
 
-**Additional context**
+\<e.g., copied & pasted shell commands & output>
-Add any other context or screenshots about the feature request here.
+
+\<e.g., screenshots only if cannot copy & paste>