diff --git a/docs/diagnostics/CoreCompat1002.md b/docs/diagnostics/CoreCompat1002.md
index e65e45f..f8aeffe 100644
--- a/docs/diagnostics/CoreCompat1002.md
+++ b/docs/diagnostics/CoreCompat1002.md
@@ -5,8 +5,8 @@ This document describes the CoreCompat1002 diagnostic.
 
 | Code   | Short Description                                                                        | Type  | Code Fix  | 
 | ------ | ---------------------------------------------------------------------------------------- | ----- | --------- | 
-| CoreCompat1002 | The underlined API is not portable to .Net Core 2.2 runtime because it is obsolete. | Error | Unavailable |
+| CoreCompat1002 | The underlined API is not portable to .Net Core 2.2 runtime because the API is obsolete. | Error | Unavailable |
 
 ## Diagnostic Description
 
-The underlined API is not portable to .Net Core 2.2 runtime because it is obsolete. Call to this API will throw PlatformNotSupportedException. You need to change your code to eliminate its usage.
+The underlined API is not portable to .Net Core 2.2 runtime because the API is obsolete. A call to this API will throw `PlatformNotSupportedException`. You need to change your code to eliminate its usage.