Apply suggestions from code review

mavasani · gewarren · web-flow · commit 79f64f1e49aa · 2020-10-02T19:39:00.000-07:00
Co-authored-by: Genevieve Warren &lt;24882762+gewarren@users.noreply.github.com&gt;
diff --git a/docs/fundamentals/code-analysis/style-rules/expression-bodied-members.md b/docs/fundamentals/code-analysis/style-rules/expression-bodied-members.md
@@ -15,14 +15,14 @@ dev_langs:
 
 The style rules in this section concern the use of [expression-bodied members](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) when the logic consists of a single expression.
 
-- [Use expression body for constructors](ide0021.md)
-- [Use expression body for methods](ide0022.md)
-- [Use expression body for operators](ide0023-ide0024.md)
-- [Use expression body for properties](ide0025.md)
-- [Use expression body for indexers](ide0026.md)
-- [Use expression body for accessors](ide0027.md)
-- [Use expression body for lambda exressions](ide0053.md)
-- [Use expression body for local functions](ide0061.md)
+- [Use expression body for constructors (IDE0021)](ide0021.md)
+- [Use expression body for methods (IDE0022)](ide0022.md)
+- [Use expression body for operators (IDE0023 and IDE0024)](ide0023-ide0024.md)
+- [Use expression body for properties (IDE0025)](ide0025.md)
+- [Use expression body for indexers (IDE0026)](ide0026.md)
+- [Use expression body for accessors (IDE0027)](ide0027.md)
+- [Use expression body for lambda exressions (IDE0053)](ide0053.md)
+- [Use expression body for local functions (IDE0061)](ide0061.md)
 
 ## See also
 
diff --git a/docs/fundamentals/code-analysis/style-rules/expression-level-preferences.md b/docs/fundamentals/code-analysis/style-rules/expression-level-preferences.md
@@ -13,7 +13,7 @@ dev_langs:
 
 ## .NET expression-level preferences
 
-The style rules in this section concern following expression-level preferences that are common to C# and Visual Basic:
+The style rules in this section concern the following expression-level preferences that are common to C# and Visual Basic:
 
 - [Use object initializers (IDE0017)](ide0017.md)
 - [Use collection initializers (IDE0028)](ide0028.md)
@@ -28,7 +28,7 @@ The style rules in this section concern following expression-level preferences t
 
 ## C# expression-level preferences
 
-The style rules in this section concern following expression-level preferences that are specific to C#:
+The style rules in this section concern the following expression-level preferences that are specific to C#:
 
 - [Inline variable declaration (IDE0018)](ide0018.md)
 - [Simplify 'default' expression (IDE0034)](ide0034.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0007-ide0008.md b/docs/fundamentals/code-analysis/style-rules/ide0007-ide0008.md
@@ -32,7 +32,7 @@ dev_langs:
 
 ## Overview
 
-The style rules in this section concern the use of the [var](/dotnet/csharp/language-reference/keywords/var) keyword versus an explicit type in a variable declaration. This rule can be applied separately to built-in types, when the type is apparent, and elsewhere.
+The style rules in this section concern the use of the [var](/dotnet/csharp/language-reference/keywords/var) keyword versus an explicit type in a variable declaration. This rule can be applied separately to built-in types, places where the type is apparent, and elsewhere.
 
 ## csharp_style_var_for_built_in_types
 
@@ -90,5 +90,6 @@ bool f = this.Init();
 
 ## See also
 
+- [var keyword](/dotnet/csharp/language-reference/keywords/var)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0016.md b/docs/fundamentals/code-analysis/style-rules/ide0016.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of `throw` expressions instead of `throw` statements.
+This style rule concerns the use of [throw expressions](../../../csharp/language-reference/keywords/throw.md#the-throw-expression) instead of `throw` statements.
 
 ## csharp_style_throw_expression
 
@@ -49,6 +49,7 @@ this.s = s;
 
 ## See also
 
+- [throw expressions](../../../csharp/language-reference/keywords/throw.md#the-throw-expression)
 - [Null-checking preferences](null-checking-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0019.md b/docs/fundamentals/code-analysis/style-rules/ide0019.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of C# [pattern matching](/dotnet/csharp/pattern-matching) over an `as` expression followed by a `null` check.
+This style rule concerns the use of C# [pattern matching](/dotnet/csharp/pattern-matching) over an `as` expression followed by a `null` check.
 
 ## csharp_style_pattern_matching_over_as_with_null_check
 
@@ -49,6 +49,7 @@ if (s != null) {...}
 
 ## See also
 
+- [Pattern matching in C#](../../../csharp/pattern-matching.md)
 - [Pattern matching preferences](pattern-matching-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0020.md b/docs/fundamentals/code-analysis/style-rules/ide0020.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of C# [pattern matching](/dotnet/csharp/pattern-matching) over doing an `is` check followed by a cast.
+This style rule concerns the use of C# [pattern matching](/dotnet/csharp/pattern-matching) over an `is` check followed by a cast.
 
 ## csharp_style_pattern_matching_over_is_with_cast_check
 
@@ -48,6 +48,7 @@ if (o is int) {var i = (int)o; ... }
 
 ## See also
 
+- [Pattern matching in C#](../../../csharp/pattern-matching.md)
 - [Pattern matching preferences](pattern-matching-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0021.md b/docs/fundamentals/code-analysis/style-rules/ide0021.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for constructors.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for constructors.
 
 ## csharp_style_expression_bodied_constructors
 
@@ -48,6 +48,7 @@ public Customer(int age) { Age = age; }
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0022.md b/docs/fundamentals/code-analysis/style-rules/ide0022.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for methods.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for methods.
 
 ## csharp_style_expression_bodied_methods
 
@@ -48,6 +48,7 @@ public int GetAge() { return this.Age; }
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0023-ide0024.md b/docs/fundamentals/code-analysis/style-rules/ide0023-ide0024.md
@@ -28,7 +28,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for operators.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for operators.
 
 ## csharp_style_expression_bodied_operators
 
@@ -52,6 +52,7 @@ public static ComplexNumber operator + (ComplexNumber c1, ComplexNumber c2)
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0025.md b/docs/fundamentals/code-analysis/style-rules/ide0025.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for properties.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for properties.
 
 ## csharp_style_expression_bodied_properties
 
@@ -48,6 +48,7 @@ public int Age { get { return _age; }}
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0026.md b/docs/fundamentals/code-analysis/style-rules/ide0026.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for indexers.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for indexers.
 
 ## csharp_style_expression_bodied_indexers
 
@@ -48,6 +48,7 @@ public T this[int i] { get { return _values[i]; } }
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0027.md b/docs/fundamentals/code-analysis/style-rules/ide0027.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for accessors.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for accessors.
 
 ## csharp_style_expression_bodied_accessors
 
@@ -48,6 +48,7 @@ public int Age { get { return _age; } set { _age = value; } }
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0034.md b/docs/fundamentals/code-analysis/style-rules/ide0034.md
@@ -48,6 +48,7 @@ void DoWork(CancellationToken cancellationToken = default(CancellationToken)) {
 
 ## See also
 
+- [`default` literal](../../../csharp/language-reference/operators/default#default-literal)
 - [Expression-level preferences](expression-level-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0039.md b/docs/fundamentals/code-analysis/style-rules/ide0039.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with the preference of use of [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions) versus lambdas (anonymous functions).
+This style rule concerns the use of [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions) versus lambdas (anonymous functions).
 
 ## csharp_style_pattern_local_over_anonymous_function
 
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0042.md b/docs/fundamentals/code-analysis/style-rules/ide0042.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with the preference of use of deconstruction in variable declarations, when possible.
+This style rule concerns the use of deconstruction in variable declarations, when possible.
 
 ## csharp_style_deconstructed_variable_declaration
 
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0053.md b/docs/fundamentals/code-analysis/style-rules/ide0053.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for lambdas.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for lambdas.
 
 ## csharp_style_expression_bodied_lambdas
 
@@ -48,6 +48,7 @@ Func<int, int> square = x => { return x * x; };
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0056.md b/docs/fundamentals/code-analysis/style-rules/ide0056.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concern the use of index operator, which is available in C# 8.0 and later.
+This style rule concern the use of the [index-from-end operator](../../../csharp/language-reference/operators/member-access-operators.md#index-from-end-operator-), which is available in C# 8.0 and later.
 
 ## csharp_style_prefer_index_operator
 
@@ -50,6 +50,7 @@ var index = names[names.Length - 1];
 
 ## See also
 
+- [index-from-end operator](../../../csharp/language-reference/operators/member-access-operators.md#index-from-end-operator-)
 - [Expression-level preferences](expression-level-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0057.md b/docs/fundamentals/code-analysis/style-rules/ide0057.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concern the use of range operator, which is available in C# 8.0 and later.
+This style rule concern the use of the [range operator](../../../csharp/language-reference/operators/member-access-operators.md#range-operator-), which is available in C# 8.0 and later.
 
 ## csharp_style_prefer_range_operator
 
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0061.md b/docs/fundamentals/code-analysis/style-rules/ide0061.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of [expression-body](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block body for [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions). Local functions are private methods of a type that are nested in another member.
+This style rule concerns the use of [expression bodies](/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members) versus block bodies for [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions). Local functions are private methods of a type that are nested in another member.
 
 ## csharp_style_expression_bodied_local_functions
 
@@ -59,6 +59,7 @@ void M()
 
 ## See also
 
+- [Expression-bodied members](../../../csharp/programming-guide/statements-expressions-operators/expression-bodied-members.md)
 - [Code style rules for expression-bodied members](expression-bodied-members.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0062.md b/docs/fundamentals/code-analysis/style-rules/ide0062.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concern with preference of [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions) being marked as `static`, when possible.
+This style rule concerns the preference of marking [local functions](/dotnet/csharp/programming-guide/classes-and-structs/local-functions) as `static`, when possible.
 
 ## csharp_prefer_static_local_function
 
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0063.md b/docs/fundamentals/code-analysis/style-rules/ide0063.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns the use of a *simple* `using` statement.
+This style rule concerns the use of `using` statements without curly braces. This alternative syntax was introduced in C# 8.0.
 
 ## csharp_prefer_simple_using_statement
 
@@ -48,6 +48,7 @@ using (var a = b) { }
 
 ## See also
 
+- [using statement](../../../csharp/language-reference/keywords/using-statement.md)
 - [Code block preferences](code-block-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0065.md b/docs/fundamentals/code-analysis/style-rules/ide0065.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with the preference of `using` directives to be placed outside or inside the namespace.
+This style rule concerns the preference of placing `using` directives outside or inside the namespace.
 
 ## csharp_using_directive_placement
 
diff --git a/docs/fundamentals/code-analysis/style-rules/ide0066.md b/docs/fundamentals/code-analysis/style-rules/ide0066.md
@@ -27,7 +27,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concern with preference of use of a `switch` expression versus a [switch statement](/dotnet/csharp/language-reference/keywords/switch).
+This style rule concerns the use of [switch expressions](../../../csharp/language-reference/operators/switch-expression.md) versus [switch statements](/dotnet/csharp/language-reference/keywords/switch).
 
 ## csharp_style_prefer_switch_expression
 
@@ -62,6 +62,7 @@ switch (x)
 
 ## See also
 
+- [switch expression](../../../csharp/language-reference/operators/switch-expression.md)
 - [Modifier preferences](modifier-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/ide1005.md b/docs/fundamentals/code-analysis/style-rules/ide1005.md
@@ -26,7 +26,7 @@ dev_langs:
 
 ## Overview
 
-This style rule concerns with preference of use of conditional coalescing operator (`?.`) when invoking a lambda expression, instead of performing a null check.
+This style rule concerns the use of the [null-conditional operator](../../../csharp/language-reference/operators/member-access-operators.md#null-conditional-operators--and-) (`?.`) when invoking a lambda expression, instead of performing a null check.
 
 ## csharp_style_conditional_delegate_call
 
@@ -48,6 +48,7 @@ if (func != null) { func(args); }
 
 ## See also
 
+- [null-conditional operator](../../../csharp/language-reference/operators/member-access-operators.md#null-conditional-operators--and-)
 - [Null-checking preferences](null-checking-preferences.md)
 - [Code style language rules](language-rules.md)
 - [Code style rules reference](index.md)
diff --git a/docs/fundamentals/code-analysis/style-rules/modifier-preferences.md b/docs/fundamentals/code-analysis/style-rules/modifier-preferences.md
@@ -13,15 +13,15 @@ dev_langs:
 
 ## .NET modifier preferences
 
-The style rules in this section concern following modifier preferences that are common to C# and Visual Basic:
+The style rules in this section concern the following modifier preferences that are common to C# and Visual Basic:
 
 - [Order modifiers (IDE0036)](ide0036.md)
 - [Add accessibility modifiers (IDE0040)](ide0040.md)
 - [Add readonly modifier (IDE0044)](ide0044.md)
 
 ## C# modifier preferences
 
-The style rules in this section concern following modifier preferences that are specific to C#:
+The style rules in this section concern the following modifier preferences that are specific to C#:
 
 - [Make local function static (IDE0062)](ide0062.md)
 
