diff --git a/aspnetcore/testing/troubleshoot.md b/aspnetcore/testing/troubleshoot.md
index 24b061c21e..cda20b5e92 100644
--- a/aspnetcore/testing/troubleshoot.md
+++ b/aspnetcore/testing/troubleshoot.md
@@ -60,4 +60,16 @@ In the **New Project** dialog for ASP.NET Core you may see the following warning
 This warning appears when the environment variable `PATH` doesn’t point to any .NET Core SDKs on the machine. To resolve this problem:
 
 * Install or verify the .NET Core SDK is installed.
-* Verify the `PATH` environment variable points to the location the SDK is installed. The installer normally sets the `PATH`.
\ No newline at end of file
+* Verify the `PATH` environment variable points to the location the SDK is installed. The installer normally sets the `PATH`.
+
+::: moniker range=">= aspnetcore-2.1"
+
+### Use of IHtmlHelper.Partial may result in application deadlocks
+
+In ASP.NET Core 2.1 and later, calling `Html.Partial` results in an analyzer warning due to the potential for deadlocks. The warning message is:
+
+*Use of IHtmlHelper.Partial may result in application deadlocks. Consider using `<partial>` Tag Helper or `IHtmlHelper.PartialAsync`.*
+
+Calls to `@Html.Partial` should be replaced by `@await Html.PartialAsync` or the partial tag helper `<partial name="_Partial" />`.
+
+::: moniker-end