Merge pull request #3420 from PowerShell/release/v2021.6.1-preview

Release v2021.6.1 preview

Author: andyleejordan

CHANGELOG.md

@@ -1,5 +1,20 @@
 # PowerShell Extension Release History
 
+## v2021.6.1-preview
+### Wednesday, June 16, 2021
+
+#### [vscode-powershell](https://github.com/PowerShell/vscode-powershell)
+
+- 📁✨ [vscode-powershell #3334](https://github.com/PowerShell/vscode-powershell/pull/3416) - Explicitly disable extension for untrusted workspaces.
+- 📺 [vscode-powershell #3378](https://github.com/PowerShell/vscode-powershell/pull/3413) - Include `$` in PowerShell word separators.
+- #️⃣ 🙏 [vscode-powershell #3390](https://github.com/PowerShell/vscode-powershell/pull/3392) - Change OS-architecture check to work with other locales. (Thanks @mat-ocl!)
+
+#### [PowerShellEditorServices](https://github.com/PowerShell/PowerShellEditorServices)
+
+- 🐛 [PowerShellEditorServices #1495](https://github.com/PowerShell/PowerShellEditorServices/pull/1500) - Prevent some exceptions.
+- #️⃣ 🙏 [vscode-powershell #3395](https://github.com/PowerShell/PowerShellEditorServices/pull/1494) - Work around `dotnet publish` bug.
+
+
 ## v2021.5.1
 ### Thursday, May 27, 2021
 

docs/development.md

@@ -53,4 +53,44 @@ code --extensionDevelopmentPath="c:\path\to\vscode-powershell" .
 
 ## 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).
+For more information on contributing snippets please read our
+[snippet requirements](https://github.com/PowerShell/vscode-powershell/blob/master/docs/community_snippets.md#contributing).
+
+## Creating a Release
+
+These are the current steps for creating a release for both the editor services
+and the extension. ADO access is restricted to Microsoft employees and is used
+to sign and validate the produced binaries before publishing on behalf of
+Microsoft. The comments are manual steps.
+
+```powershell
+Import-Module ./tools/ReleaseTools.psm1
+Update-Changelog -RepositoryName PowerShellEditorServices -Version <version>
+Update-Changelog -RepositoryName vscode-powershell -Version <version>
+# Amend changelog as necessary
+Update-Version -RepositoryName PowerShellEditorServices
+Update-Version -RepositoryName vscode-powershell
+# Push branches to GitHub and ADO
+# Open PRs for review
+# Download and test assets (assert correct PSES is included)
+# Rename VSIX correctly
+New-DraftRelease -RepositoryName PowerShellEditorServices
+New-DraftRelease -RepositoryName vscode-powershell
+# Point releases to branches for automatic tagging
+# Upload PowerShellEditorServices.zip (for other extensions)
+# Upload VSIX and Install-VSCode.ps1
+# Publish draft releases and merge (don't squash!) branches
+vsce publish --packagePath ./PowerShell-<version>.vsix
+# Update Install-VSCode.ps1 on gallery
+Publish-Script -Path ./Install-VSCode.ps1 -NuGetApiKey (Get-Secret "PowerShell Gallery API Key" -AsPlainText)
+```
+
+### Pending Improvements
+
+* `Update-Changelog` should verify the version is in the correct format
+* `Update-Changelog` could be faster by not downloading _every_ PR
+* `Update-Changelog` should use exactly two emoji and in the right order
+* `Update-Version` could be run by `Update-Changelog`
+* `New-DraftRelease` could automatically set the tag pointers and upload the binaries
+* The build should emit an appropriately named VSIX instead of us manually renaming it
+* A `Publish-Binaries` function could be written to push the binaries out

package.json

@@ -1,10 +1,10 @@
 {
-  "name": "powershell",
-  "displayName": "PowerShell",
-  "version": "2021.5.1",
-  "preview": false,
+  "name": "powershell-preview",
+  "displayName": "PowerShell Preview",
+  "version": "2021.6.1",
+  "preview": true,
   "publisher": "ms-vscode",
-  "description": "Develop PowerShell modules, commands and scripts in Visual Studio Code!",
+  "description": "(Preview) Develop PowerShell modules, commands and scripts in Visual Studio Code!",
   "engines": {
     "vscode": "^1.53.0"
   },