dev-proxy
dev-proxy copied to clipboard
Create troubleshooting page in docs
To help customers troubleshoot proxy not working as intended, we should create a page to which we can point to in-product, from issues, on social, etc.
The page should contain walk customers through the same troubleshooting steps that we'd take if we're to help them 1:1. Proposed structure:
Symptom: Proxy is not intercepting requests
- no requests intercepted
- is proxy running
- is it registered as system proxy
- Have you configured correct url to watch
- Are you using the right config file
- Are you using proxy with a Node app
- Are you using proxy with PowerShell on Windows
Symptom: Requests intercepted but passed through
Symptom: You get an SSL error in your app when using Dev Proxy:
- Do you have the proxy cert installed
- Is it trusted
Nice idea.
How would folks get to the page and how would they know that it exists?
Are you thinking of a doctor
command?
To raise awareness of the page, we should do the following:
- have an aka link, eg. aka.ms/devproxy/help
- show the link when proxy starts
- show the link when folks invoke help on-demand #586
- show the link on the issue template so that folks can debug proxy before they submit an issue
I'm not sure if a doctor command would help us automatically detect the things that need to be checked in order to determine what's wrong.