From 2fd08315f749a2a2a9a4289285973493070c91f7 Mon Sep 17 00:00:00 2001 From: Tyler Leonhardt Date: Mon, 11 Mar 2019 18:53:43 -0700 Subject: [PATCH 1/3] initial readme for Azure Data Studio marketplace --- docs/azure_data_studio/README.md | 10 ++ .../README_FOR_MARKETPLACE.md | 105 ++++++++++++++++++ 2 files changed, 115 insertions(+) create mode 100644 docs/azure_data_studio/README.md create mode 100644 docs/azure_data_studio/README_FOR_MARKETPLACE.md diff --git a/docs/azure_data_studio/README.md b/docs/azure_data_studio/README.md new file mode 100644 index 0000000000..65dc99c7d7 --- /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 SQL DBAs 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..3d6472f21d --- /dev/null +++ b/docs/azure_data_studio/README_FOR_MARKETPLACE.md @@ -0,0 +1,105 @@ +# PowerShell Language Support for Azure Data Studio + +[![Codacy Badge](https://api.codacy.com/project/badge/Grade/df06b9909e7442cebc1132bda0b8c0e3)](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) +[![windows build](https://img.shields.io/appveyor/ci/PowerShell/vscode-powershell/master.svg?label=windows+build)](https://ci.appveyor.com/project/PowerShell/vscode-powershell) [![linux/macos build](https://img.shields.io/travis/PowerShell/vscode-powershell/master.svg?label=linux/macos+build)](https://travis-ci.org/PowerShell/vscode-powershell) [![Join the chat at https://gitter.im/PowerShell/vscode-powershell](https://badges.gitter.im/PowerShell/vscode-powershell.svg)](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 [Visual Studio Code 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) by following the +[Install from a VSIX](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix) +instructions. The easiest way is 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 From 2b1a3b7ca77e79d47b4e4b7204929cece098a213 Mon Sep 17 00:00:00 2001 From: Tyler Leonhardt Date: Mon, 11 Mar 2019 18:59:11 -0700 Subject: [PATCH 2/3] wording --- docs/azure_data_studio/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_data_studio/README.md b/docs/azure_data_studio/README.md index 65dc99c7d7..7af74b25fe 100644 --- a/docs/azure_data_studio/README.md +++ b/docs/azure_data_studio/README.md @@ -1,6 +1,6 @@ # Azure Data Studio Docs -[Azure Data Studio](https://github.com/Microsoft/azuredatastudio) is a VSCode-like IDE primarily targeted at SQL DBAs and is a fork of VSCode. Since it's a fork of VSCode, many extensions "just work" including the PowerShell extension. +[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. From 3b3ada376825e25a3b495cff884be3ce54e15b0e Mon Sep 17 00:00:00 2001 From: Tyler Leonhardt Date: Mon, 11 Mar 2019 19:05:01 -0700 Subject: [PATCH 3/3] vscode reference --- docs/azure_data_studio/README_FOR_MARKETPLACE.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/azure_data_studio/README_FOR_MARKETPLACE.md b/docs/azure_data_studio/README_FOR_MARKETPLACE.md index 3d6472f21d..87caf6e90e 100644 --- a/docs/azure_data_studio/README_FOR_MARKETPLACE.md +++ b/docs/azure_data_studio/README_FOR_MARKETPLACE.md @@ -31,13 +31,11 @@ Read the [FAQ](https://github.com/PowerShell/vscode-powershell/wiki/FAQ) for ans ## Installing the Extension You can install the official release of the PowerShell extension by following the steps -in the [Visual Studio Code documentation](docs.microsoft.com/en-us/sql/azure-data-studio/extensions). +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) by following the -[Install from a VSIX](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix) -instructions. The easiest way is through the command line: +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