diff --git a/docs/community_snippets.md b/docs/community_snippets.md index 4381f69094..da3aff4a4b 100644 --- a/docs/community_snippets.md +++ b/docs/community_snippets.md @@ -398,7 +398,14 @@ Add the Send-MailMessage cmdlet with the most common parameters in a hashtable f ## Contributing -If you'd like to add a snippet to this list, [open a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) with the following changes: +To optimize snippet usability and discoverability for end users we will only ship snippets in the extension which we believe meet the following requirements: +- Must be broadly applicable to most PowerShell extension users +- Must be substantially different from existing snippets or intellisense +- Must not violate any intellectual property rights + +If your snippet does not meet these requirements but would still be useful to customers we will include it in our list of [Awesome Community Snippets](https://github.com/PowerShell/vscode-powershell/blob/master/docs/community_snippets.md). Additionally, snippet creators can publish snippet libraries as standalone extensions in the [VSCode Marketplace](https://code.visualstudio.com/api/working-with-extensions/publishing-extension). + +If you'd like a snippet to be considered for addition to the list, [open a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) with the following changes: ### Table of contents diff --git a/docs/development.md b/docs/development.md index 67653fd605..0167ef38a9 100644 --- a/docs/development.md +++ b/docs/development.md @@ -55,4 +55,8 @@ When you build, this will: - Add a warning to the top of the README.md to warn users not to have the stable and preview version enabled at the same time - Adds "Preview" in a few places in the package.json -This mechanism is mostly used for releases. +This mechanism is mostly used for releases + +## Contributing Snippets + +For more information on contributing snippets please read our [snippet requirements](https://github.com/PowerShell/vscode-powershell/blob/master/docs/community_snippets.md#contributing).