From 6b1b6762691cd8b76203d642f6d1ddf0081a561c Mon Sep 17 00:00:00 2001
From: Andrew Schwartzmeyer <andrew@schwartzmeyer.com>
Date: Tue, 24 Aug 2021 11:27:55 -0700
Subject: [PATCH 1/2] Update CHANGELOG for `v2021.8.2`

---
 CHANGELOG.md | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0e0f2591da..1fe220ce1a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,25 @@
 # PowerShell Extension Release History
 
-## v2021.8.2-preview
-### Monday, August 23, 2021
+## v2021.8.2
+### Tuesday, August 24, 2021
+
+This release also contains all changes listed in [v2021.8.1-preview](#v202181-preview)
+below. Notably it fixes several major issues when debugging scripts that were caused by
+threading deadlocks in both PowerShell Editor Services and its library, [OmniSharp's C#
+Language Server Protocol][omnisharp] that we resolved by setting the compiler to treat
+[CA2007][] as an error. This allowed us to programmatically fix _every_ awaited task to
+use `.ConfigureAwait(false)` and so avoid deadlocks caused by the introduction of new
+synchronization contexts in user code (such as the use of `System.Windows.Forms`). By
+fixing this through a compiler rule, we effectively prevent the issue from recurring.
+Additionally, we not only added a full regression test for this scenario but also
+re-enabled all the prior `DebugService` unit tests in PowerShell Editor Services.
+
+While there is still much work to do, we are making significant headway on improve the
+debugger's reliability, one of our current project focuses. See the [Debugger Reliability
+Project](https://github.com/PowerShell/vscode-powershell/projects/9) for our progress.
+
+[omnisharp]: https://github.com/OmniSharp/csharp-language-server-protocol
+[CA2007]: https://docs.microsoft.com/en-us/dotnet/fundamentals/code-analysis/quality-rules/ca2007
 
 #### [vscode-powershell](https://github.com/PowerShell/vscode-powershell)
 

From ec63b415865b6a6292a9fda2352fd5739c7f8d83 Mon Sep 17 00:00:00 2001
From: Andrew Schwartzmeyer <andrew@schwartzmeyer.com>
Date: Tue, 24 Aug 2021 11:28:04 -0700
Subject: [PATCH 2/2] Bump version to `v2021.8.2`

---
 package.json | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index b274a07a6a..5b8a85bb7a 100644
--- a/package.json
+++ b/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "powershell-preview",
-  "displayName": "PowerShell Preview",
+  "name": "powershell",
+  "displayName": "PowerShell",
   "version": "2021.8.2",
-  "preview": true,
+  "preview": false,
   "publisher": "ms-vscode",
-  "description": "(Preview) Develop PowerShell modules, commands and scripts in Visual Studio Code!",
+  "description": "Develop PowerShell modules, commands and scripts in Visual Studio Code!",
   "engines": {
     "vscode": "^1.53.0"
   },
@@ -16,7 +16,7 @@
     "Snippets",
     "Linters"
   ],
-  "icon": "media/PowerShell_Preview_Icon.png",
+  "icon": "media/PowerShell_Icon.png",
   "galleryBanner": {
     "color": "#ACD1EC",
     "theme": "light"