diff --git a/docs/azure_data_studio/README.md b/docs/azure_data_studio/README.md
new file mode 100644
index 0000000000..7af74b25fe
--- /dev/null
+++ b/docs/azure_data_studio/README.md
@@ -0,0 +1,10 @@
+# Azure Data Studio Docs
+
+[Azure Data Studio](https://github.com/Microsoft/azuredatastudio) is a VSCode-like IDE primarily targeted at database administrators and is a fork of VSCode. Since it's a fork of VSCode, many extensions "just work" including the PowerShell extension.
+
+This folder contains any docs for PowerShell extension support in Azure Data Studio.
+
+Table of Contents:
+
+* `README.md` - This file. It's purely for information about this folder and shouldn't be used elsewhere.
+* `README_FOR_MARKETPLACE.md` - The markdown file that will be shown when you look at the PowerShell extension in the Azure Data Studio marketplace.
diff --git a/docs/azure_data_studio/README_FOR_MARKETPLACE.md b/docs/azure_data_studio/README_FOR_MARKETPLACE.md
new file mode 100644
index 0000000000..87caf6e90e
--- /dev/null
+++ b/docs/azure_data_studio/README_FOR_MARKETPLACE.md
@@ -0,0 +1,103 @@
+# PowerShell Language Support for Azure Data Studio
+
+[](https://app.codacy.com/app/TylerLeonhardt/vscode-powershell?utm_source=github.com&utm_medium=referral&utm_content=PowerShell/vscode-powershell&utm_campaign=Badge_Grade_Dashboard)
+[](https://ci.appveyor.com/project/PowerShell/vscode-powershell) [](https://travis-ci.org/PowerShell/vscode-powershell) [](https://gitter.im/PowerShell/vscode-powershell?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+This extension provides rich PowerShell language support for [Azure Data Studio](github.com/Microsoft/azuredatastudio).
+Now you can write and debug PowerShell scripts using the excellent IDE-like interface
+that Azure Data Studio provides.
+
+## Platform support
+
+- **Windows 7 through 10** with Windows PowerShell v3 and higher, and PowerShell Core
+- **Linux** with PowerShell Core (all PowerShell-supported distributions)
+- **macOS** with PowerShell Core
+
+Read the [FAQ](https://github.com/PowerShell/vscode-powershell/wiki/FAQ) for answers to common questions.
+
+## Features
+
+- Syntax highlighting
+- Code snippets
+- IntelliSense for cmdlets and more
+- Rule-based analysis provided by [PowerShell Script Analyzer](http://github.com/PowerShell/PSScriptAnalyzer)
+- Go to Definition of cmdlets and variables
+- Find References of cmdlets and variables
+- Document and workspace symbol discovery
+- Run selected selection of PowerShell code using F8
+- Launch online help for the symbol under the cursor using Ctrl+F1
+- Basic interactive console support!
+
+## Installing the Extension
+
+You can install the official release of the PowerShell extension by following the steps
+in the [Azure Data Studio documentation](docs.microsoft.com/en-us/sql/azure-data-studio/extensions).
+In the Extensions pane, search for "PowerShell" extension and install it there. You will
+get notified automatically about any future extension updates!
+
+You can also install a VSIX package from our [Releases page](https://github.com/PowerShell/vscode-powershell/releases) and install it through the command line:
+
+```powershell
+azuredatastudio --install-extension PowerShell-.vsix
+```
+
+## Reporting Problems
+
+If you experience any problems with the PowerShell Extension, see
+[the troubleshooting docs](./docs/troubleshooting.md) for information
+on diagnosing and reporting issues.
+
+#### Security Note
+For any security issues, please see [here](./docs/troubleshooting.md#note-on-security).
+
+## Example Scripts
+
+There are some example scripts in the extension's `examples` folder that you can
+use to discover PowerShell editing and debugging functionality. Please
+check out the included [README.md](examples/README.md) file to learn more about
+how to use them.
+
+This folder can be found at the following path:
+
+```powershell
+$HOME/.azuredatastudio/extensions/ms-vscode.PowerShell-/examples
+```
+
+or if you're using the preview version of the extension
+
+ ```powershell
+$HOME/.azuredatastudio/extensions/ms-vscode.powershell-preview-/examples
+```
+
+To open/view the extension's examples in Visual Studio Code, run the following from your PowerShell command prompt:
+
+```powershell
+code (Get-ChildItem $Home\.azuredatastudio\extensions\ms-vscode.PowerShell-*\examples)[-1]
+```
+
+## Contributing to the Code
+
+Check out the [development documentation](docs/development.md) for more details
+on how to contribute to this extension!
+
+## Maintainers
+
+- [Keith Hill](https://github.com/rkeithhill) - [@r_keith_hill](http://twitter.com/r_keith_hill)
+- [Tyler Leonhardt](https://github.com/tylerl0706) - [@TylerLeonhardt](http://twitter.com/tylerleonhardt)
+- [Rob Holt](https://github.com/rjmholt)
+
+## License
+
+This extension is [licensed under the MIT License](LICENSE.txt). Please see the
+[third-party notices](Third%20Party%20Notices.txt) file for details on the third-party
+binaries that we include with releases of this project.
+
+## [Code of Conduct][conduct-md]
+
+This project has adopted the [Microsoft Open Source Code of Conduct][conduct-code].
+For more information see the [Code of Conduct FAQ][conduct-FAQ] or contact [opencode@microsoft.com][conduct-email] with any additional questions or comments.
+
+[conduct-code]: http://opensource.microsoft.com/codeofconduct/
+[conduct-FAQ]: http://opensource.microsoft.com/codeofconduct/faq/
+[conduct-email]: mailto:opencode@microsoft.com
+[conduct-md]: https://github.com/PowerShell/vscode-powershell/blob/master/CODE_OF_CONDUCT.md