From 4977f90efaf03787d9cb804a1c4f18bb78337d0e Mon Sep 17 00:00:00 2001 From: Andrew Schwartzmeyer Date: Wed, 16 Jun 2021 16:57:31 -0700 Subject: [PATCH 1/3] Document release process --- docs/development.md | 42 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/docs/development.md b/docs/development.md index cce0c968b4..c75eda1616 100644 --- a/docs/development.md +++ b/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 +Update-Changelog -RepositoryName vscode-powershell -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-.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 From af9f13fefe4f289649f5380dbd1550291e370fd8 Mon Sep 17 00:00:00 2001 From: Andrew Schwartzmeyer Date: Wed, 16 Jun 2021 17:03:21 -0700 Subject: [PATCH 2/3] Update CHANGELOG for v2021.6.1-preview --- CHANGELOG.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index b4e715f6d4..3f2ee6fad5 100644 --- a/CHANGELOG.md +++ b/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 From 5ad4b875296ea2ae44d185edeb205e9194630bfd Mon Sep 17 00:00:00 2001 From: Andrew Schwartzmeyer Date: Wed, 16 Jun 2021 17:05:23 -0700 Subject: [PATCH 3/3] Bump version to v2021.6.1-preview --- package.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/package.json b/package.json index d518cb378d..ba072aa772 100644 --- a/package.json +++ b/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" },