Reduce friction for bug reporting (#14911)

- Update error message to present troubleshooting and issue filing equally
- Remove dead GitHub Discussions link from troubleshooting page
- Simplify bug report template from 6 sections to 3
- Add config.yml to show troubleshooting link in issue chooser
- Lead CONTRIBUTING.md with "We welcome bug reports!"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Dan Guido
2025-11-28 23:45:29 -05:00
committed by GitHub
co-authored by Claude
parent 56cd17b21a
commit 11e4dcae22
5 changed files with 15 additions and 25 deletions
+5 -22
View File
@@ -1,32 +1,15 @@
---
name: Bug report
about: Create a report to help us improve
about: Report a problem with Algo
---
**Describe the bug**
**What happened?**
A clear and concise description of what the bug is.
**To Reproduce**
**Environment** (cloud provider, OS, WireGuard or IPsec)
Steps to reproduce the behavior:
1. Do this..
2. Do that..
3. ..
**Expected behavior**
A clear and concise description of what you expected to happen.
**Additional context**
Add any other context about the problem here.
**Full log**
<!--- Put here the FULL LOG after you run the ./algo script below -->
**Output**
```
PUT THE OUTPUT HERE
Paste any error messages or relevant output here
```
+6
View File
@@ -0,0 +1,6 @@
---
blank_issues_enabled: true
contact_links:
- name: Troubleshooting Guide
url: https://trailofbits.github.io/algo/troubleshooting.html
about: Check common issues and solutions before filing
+1 -1
View File
@@ -1,6 +1,6 @@
### Filing New Issues
* Check that your issue is not already described in the [FAQ](docs/faq.md), [troubleshooting](docs/troubleshooting.md) docs, or an [existing issue](https://github.com/trailofbits/algo/issues)
* We welcome bug reports! Before filing, a quick check of the [FAQ](docs/faq.md) or [troubleshooting](docs/troubleshooting.md) docs might have your answer
* Algo automatically installs dependencies with uv - no manual setup required
* We support modern clients: macOS 12+, iOS 15+, Windows 11+, Ubuntu 22.04+, etc.
* Supported cloud providers: DigitalOcean, AWS, Azure, GCP, Vultr, Hetzner, Linode, OpenStack, CloudStack
+2 -1
View File
@@ -201,8 +201,9 @@ cloud_providers:
fail_hint:
- Sorry, but something went wrong!
- Please check the troubleshooting guide.
- Check troubleshooting for common fixes, or file an issue if you found a bug.
- https://trailofbits.github.io/algo/troubleshooting.html
- https://github.com/trailofbits/algo/issues/new
booleans_map:
Y: true
+1 -1
View File
@@ -517,4 +517,4 @@ Get-WinEvent -LogName "Microsoft-Windows-VPN-Client/Operational" -MaxEvents 50
## I have a problem not covered here
If you have an issue that you cannot solve with the guidance here, [create a new discussion](https://github.com/trailofbits/algo/discussions) and ask for help. If you think you found a new issue in Algo, [file an issue](https://github.com/trailofbits/algo/issues/new).
If you have an issue that you cannot solve with the guidance here, please [file an issue](https://github.com/trailofbits/algo/issues/new). We welcome bug reports and want to hear about problems you encounter.