diff --git a/Troubleshoot.md b/Troubleshoot.md
new file mode 100644
index 000000000..cfff49db8
--- /dev/null
+++ b/Troubleshoot.md
@@ -0,0 +1,42 @@
+# Troubleshooting Errors
+Many of the issues can be caught before submitting your PR, if you follow these steps:
+1) Validate the manifest file by running ```winget validate <manifest>```
+2) Run the installer with the local installer.  This will verify the Sha256 HASH.  ```winget install -m <manifest>```
+
+Once those steps pass, here are some troubleshooting tips.
+
+## Manifest-Validation-Error 
+Manifest validation errors indicate that there is a problem with the manifest file.  Many of the issues can be caught before submitting your PR, if you validated the manifest file before submission:  ```winget validate <manifest>```
+
+For documentation on the manifest specification, please see [manifest](https://docs.microsoft.com/windows/package-manager/package/manifest.md)
+
+Here are some common mistakes not discovered by the winget validater.
+1) Make sure the publisher folder and application name folder match the Id.  
+
+```id: <publisher>.<name>```  
+
+```folder path: publisher\name```
+
+2) Check for typos in the version.  The file name of the manifest must match the Version in the manifest  
+
+```Version: 123.456```  
+
+```filename: 123.456.yaml```
+
+
+## Binary-Validation-Error
+Binary validation errors indicate that the installer failed static analysis.  
+
+Here are some common causes for the Binary-Validation-Error label:
+1) The Sha256 HASH in the manifest does not match the HASH of the installer.
+2) The URL is not available. Make sure the URL to the installer is available.
+3) The installer has triggered false positive.  If your installer is detected wrongly as malware, you can submit the installer to the defender team for [analysis](https://docs.microsoft.com/en-us/windows/security/threat-protection/windows-defender-antivirus/antivirus-false-positives-negatives#submit-a-file-to-microsoft-for-analysis) for a false positive.
+
+## SmartScreen-Validation-Error
+SmartScreen validation errors indicate that the URL you provided has a bad reputation.
+
+## Internal-Error
+Internal-Errors indicate there was an error hit by the service.  Microsoft will investigate these and pursue a fix.  For a list of known issues, see our repo [issues](https://github.com/microsoft/winget-pkgs/issues)
+
+
+