Add troubleshooting.md file to help with common problems

This change adds a new documentation file called troubleshooting.md which
gives the user guidance on how to resolve commonly occuring problems when
using this extension.  For now it just contains information on how to
install OpenSSL when using the extension on OS X.

Author: daviwil

docs/troubleshooting.md

@@ -0,0 +1,49 @@
+# Troubleshooting PowerShell Extension Issues
+
+This document contains troubleshooting steps for commonly reported issues when using the
+PowerShell extension for Visual Studio Code.
+
+## Mac OS X
+
+### 1. PowerShell IntelliSense does not work, can't debug scripts
+
+The most common problem when the PowerShell extension doesn't work on Mac OS X is that
+OpenSSL is not installed.  You can check for the installation of OpenSSL by looking for
+the following two files:
+
+```
+/usr/local/lib/libcrypto.1.0.0.dylib
+/usr/local/lib/libssl.1.0.0.dylib
+```
+
+The extension should check for these files and direct you to this documentation if you
+do not have OpenSSL isntalled.
+
+#### Installing OpenSSL via Homebrew
+
+You can use Homebrew to easily install OpenSSL.  First install Homebrew and then run the following command:
+
+```
+brew install openssl
+```
+
+Restart VS Code after completing the installation and verify that the extension is working correctly.
+
+#### Installing OpenSSL via MacPorts
+
+If you prefer to use [MacPorts](https://www.macports.org/), you can run the following command to install OpenSSL:
+
+```
+sudo port install openssl
+```
+
+You will need to take an additional step once installation completes:
+
+```
+sudo ln -s /opt/local/lib/libcrypto.1.0.0.dylib /usr/local/lib/
+sudo ln -s /opt/local/lib/libssl.1.0.0.dylib /usr/local/lib/
+```
+
+Thanks to [@MarlonRodriguez](https://github.com/MarlonRodriguez) for the tip!
+
+Restart VS Code after completing the installation and verify that the extension is working correctly.