Updated based on peer review feedback

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>

Author: Prabha Kylasamiyer Sundara Rajan

docs/topics/rules-development/create-csharp-custom-rule.adoc

@@ -13,8 +13,8 @@ You can use the following custom rule to check if {ProductShortName} triggers an
 
 .Prerequisites
 
-* You installed `ilspycmd` and `paket` dependencies
-* You installed `dotnet tools` and exported the `dotnet tools` path by using the `export PATH="$PATH:<path/to/.dotnet/tools"` command
+* You installed the `ilspycmd` and `paket` dependencies.
+* You installed the `dotnet tools` and exported the `dotnet tools` path by using the `export PATH="$PATH:<path/to/.dotnet/tools"` command.
 
 .Procedure
 . Create a `csharp-rule.yaml` file in your `Home` directory. 
@@ -57,7 +57,7 @@ You can use the following custom rule to check if {ProductShortName} triggers an
 
 . Open a C# project that has the `WebMatrix.WebData.WebSecurity` class.
 
-. Run the following command in the {ProductShortName} CLI:
+. Run an analysis with the following command in the {ProductShortName} CLI:
 +
 
 [source, terminal]
@@ -68,7 +68,7 @@ $ ./mta-cli analyze -i _path_to_nerd-dinner_ -o _path_to_report_ --overwrite --r
 
 [NOTE]
 ====
-Add the `--overwrite` option if you want to use the same directory for the report when you run subsequent tests. {ProductShortName} overwrites the current report with the result of the latest analysis that you run.
+Add the `--overwrite` option if you want to use the same directory for the report when you run subsequent tests. {ProductShortName} overwrites the current report with the result of the latest analysis that you ran.
 ====
 
 . Open the static report at _path_to_report_ in your browser.

docs/topics/rules-development/yaml-dotnet-provider.adoc

@@ -24,7 +24,7 @@ when:
 ----
 where:
 
- `pattern` :: A regular expression pattern to match the needed reference. For example, `System.Web.Http.ApiController.*`
- `location` :: Specifies the location in the source code to search the pattern. For example, `CLASS`.
-
+* `pattern` :: A regular expression pattern to match the needed reference. For example, `System.Web.Http.ApiController.*`
+* `location` :: Specifies the location in the source code to search the pattern. For example, `CLASS`.
++
 NOTE: You can also specify `location` as `METHOD`, `FIELD`, or `ALL`. When the `location` is `ALL`, the `C#` provider runs a search query for namespaces, structure types, and interfaces.

docs/topics/rules-development/yaml-provider-conditions.adoc

@@ -464,59 +464,57 @@ when:
 
 |location
 |Yes
-a|Specify one of the following for which {ProductShortName} runs a search query. 
-
- * Type reference including classes, interfaces and structure types (struct)
-
- For example, 
-[subs="+quotes"]
-----
-when:
-  csharp.referenced:
-    location: CLASS
-    pattern: System.Web.Http.ApiController.*
-----
- For example, 
-[subs="+quotes"]
-----
-when:
-  csharp.referenced:
-    location: ALL
-    pattern: "System.Console.Print*"
-----
-
- * Method calls and definitions
+a|Specify one of the following for which {ProductShortName} runs a search query:
+
+ * Type reference including classes, interfaces and structure types (struct). For example: 
+ +
+
+  [subs="+quotes"]
+  ----
+  when:
+    csharp.referenced:
+      location: CLASS
+      pattern: System.Web.Http.ApiController.*
+  ----
+  For example,
+
+  [subs="+quotes"]
+  ----
+  when:
+    csharp.referenced:
+      location: ALL
+      pattern: "System.Console.Print*"
+  ----
+
+ * Method calls and definitions. For example:
+
+  [subs="+quotes"]
+  ----
+  when:
+    csharp.referenced:
+      location: METHOD
+      pattern: "*.AppDomain.Unload"
+  ----
+
+ * Field usages and declaration. For example:
+
+  [subs="+quotes"]
+  ----
+  when:
+    csharp.referenced:
+      location: FIELD
+      pattern: "DotNetOpenAuth.AspNet.AuthenticationResult.Provider"
+  ----
+
+ * Namespace imports and usages. For example: 
 
- For example, 
-[subs="+quotes"]
-----
-when:
-  csharp.referenced:
-    location: METHOD
-    pattern: "*.AppDomain.Unload"
-----
-
- * Field usages and declaration
-
- For example, 
-[subs="+quotes"]
-----
-when:
-  csharp.referenced:
-    location: FIELD
-    pattern: "DotNetOpenAuth.AspNet.AuthenticationResult.Provider"
-----
-
- * Namespace imports and usages
-
- For example, 
-[subs="+quotes"]
-----
-when:
-  csharp.referenced:
-    location: ALL
-    pattern: "System.Windows.Forms"
-----
+  [subs="+quotes"]
+  ----
+  when:
+    csharp.referenced:
+      location: ALL
+      pattern: "System.Windows.Forms"
+  ----
 
  * `ALL` - You can also specify `ALL` as `location` to run a search query on any location in the code, including namespaces, structure types, and interfaces.
 |===

docs/topics/vscode/proc_vscode-analyzing-application.adoc

@@ -7,7 +7,7 @@ You can run a static code analysis of an application with or without enabling th
 
 .Prerequisites
 
-* You opened a project in your VS Code workspace.
+* You opened a project in your Visual Studio Code workspace.
 * You installed the following for `.NET` or `C#` application analysis:
 .. The {ProductShortName} Core and `C#` extensions 
 .. `dotnet tools` and added it to the `$PATH` environment variable