Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Feature: Improved Explanation in Troubleshooting of Where to File a New Issue #2608

Closed
bgausden opened this issue May 8, 2017 · 0 comments · Fixed by Homebrew/homebrew-core#13411 or #2618
Closed

Feature: Improved Explanation in Troubleshooting of Where to File a New Issue #2608

bgausden opened this issue May 8, 2017 · 0 comments · Fixed by Homebrew/homebrew-core#13411 or #2618
Assignees
@MikeMcQuaid

Comments

@bgausden
Copy link

bgausden commented May 8, 2017

Feature/Suggestion:

The current troubleshooting doc and the issue template perhaps don't do enough to explain to an en-user where they should be filing an issue.

Case in point, when striking an issue installing wireshark-chmodbpf I open a case in what turns out to be the wrong project. (In this case opened in homebrew-core but should have been homebrew-cask).

How an end-user is supposed to determine which project is the appropriate location for a new issue when they're a) not aware of which projects exist and b) are probably not qualified to classify the type of error and hence which project to open the issue in...

Additional help text would be great and would encourage more users to actually file issues rather than abandoning the effort because of doubt around a) how to file and issue and b) where to file an issue.
This was referenced May 10, 2017
Merged
Merged
@MikeMcQuaid MikeMcQuaid self-assigned this May 10, 2017
@MikeMcQuaid MikeMcQuaid added the in progress Maintainers are working on this label May 10, 2017
@MikeMcQuaid MikeMcQuaid removed the in progress Maintainers are working on this label May 10, 2017
MikeMcQuaid added a commit to Homebrew/homebrew-core that referenced this issue May 10, 2017
@MikeMcQuaid
ISSUE_TEMPLATE: tweak instructions.
f038f9d 
- Note that Homebrew Cask issues should be filed elsewhere.
- Make `brew`/homebrew-core issue differential in simpler language
- Tell people to fix all `brew doctor` issues
- Refer to the issue checklist and make it even more clear and prominent
  that we may close it out immediately if they don't use it.

Fixes Homebrew/brew#2608
@Homebrew Homebrew locked and limited conversation to collaborators May 4, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees

@MikeMcQuaid MikeMcQuaid

Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

ISSUE_TEMPLATE: tweak instructions.
Tweak troubleshooting docs and issue template MikeMcQuaid/brew
2 participants
@MikeMcQuaid @bgausden