Merge pull request #6353 from mikadumont/docs-bash

closing bugs from doc bash

Author: PRMerger19

docs/ide/editorconfig-formatting-conventions.md

@@ -1,14 +1,14 @@
 ---
 title: .NET formatting conventions for EditorConfig
-ms.date: 07/17/2019
+ms.date: 03/31/2020
 ms.topic: reference
 dev_langs:
 - CSharp
 - VB
 helpviewer_keywords:
 - formatting conventions [EditorConfig]
-author: TerryGLee
-ms.author: tglee
+author: mikadumont
+ms.author: midumont
 manager: jillfra
 ms.workload:
 - dotnet
@@ -145,6 +145,8 @@ The formatting rules in this section apply only to C# code.
 - [Wrap options](#wrap-options)
   - csharp_preserve_single_line_statements
   - csharp_preserve_single_line_blocks
+- [Using directive options](#using-directive-options) 
+  - csharp_using_directive_placement
 
 ### New-line options
 
@@ -1204,6 +1206,50 @@ public int MyProperty
 }
 ```
 
+- [Using directive options](#using-directive-options) 
+  - csharp_using_directive_placement
+  
+### Using directive options
+
+This formatting rule concerns the use of using directives being placed inside versus outside a namespace.
+
+Example *.editorconfig* file:
+
+```ini
+# 'using' directive preferences
+[*.cs]
+csharp_using_directive_placement = outside_namespace
+csharp_using_directive_placement = inside_namespace
+```
+
+#### csharp_using_directive_placement
+
+|||
+|-|-|
+| **Rule name** | csharp_using_directive_placement |
+| **Applicable languages** | C# |
+| **Introduced version** | Visual Studio 2019 version 16.1 |
+| **Values** | `outside_namespace` - Leave using directives outside namespace<br /><br />`inside_namespace` - Leave using directives inside namespace |
+| **Visual Studio default** | `outside_namespace` |
+
+Code examples:
+
+```csharp
+// csharp_using_directive_placement = outside_namespace
+using System;
+
+namespace Conventions
+{
+
+}
+
+// csharp_using_directive_placement = inside_namespace
+namespace Conventions
+{
+    using System;
+}
+```
+
 ## See also
 
 - [Language conventions](editorconfig-language-conventions.md)

docs/ide/editorconfig-language-conventions.md

@@ -1,14 +1,14 @@
 ---
 title: .NET language conventions for EditorConfig
-ms.date: 09/23/2019
+ms.date: 03/31/2020
 ms.topic: reference
 dev_langs:
 - CSharp
 - VB
 helpviewer_keywords:
 - language code style rules [EditorConfig]
-author: TerryGLee
-ms.author: tglee
+author: mikadumont
+ms.author: midumont
 manager: jillfra
 ms.workload:
 - dotnet
@@ -88,7 +88,6 @@ The style rules in this section are applicable to both C# and Visual Basic.
   - dotnet\_style\_predefined\_type\_for\_member_access
 - [Modifier preferences](#normalize-modifiers)
   - dotnet\_style\_require\_accessibility_modifiers
-  - csharp\_preferred\_modifier_order
   - visual\_basic\_preferred\_modifier_order
   - dotnet\_style\_readonly\_field
 - [Parentheses preferences](#parentheses-preferences)
@@ -110,6 +109,7 @@ The style rules in this section are applicable to both C# and Visual Basic.
 - ["Null" checking preferences](#null-checking-preferences)
   - dotnet\_style\_coalesce_expression
   - dotnet\_style\_null_propagation
+  - dotnet\_style\_prefer\_is\_null\_check\_over\_reference\_equality\_method
 
 ### <a name="this-and-me"></a>"This." and "Me." qualifiers
 
@@ -403,6 +403,43 @@ Public Class MyClass
 End Class
 ```
 
+#### visual_basic_style_unused_value_expression_statement_preference
+
+|||
+|-|-|
+| **Rule name** | visual_basic_style_unused_value_expression_statement_preference |
+| **Rule ID** | IDE0058 |
+| **Applicable languages** | Visual Basic |
+| **Values** | `unused_local_variable:silent` |
+| **Visual Studio default** | `unused_local_variable:silent` |
+
+Code examples:
+
+```vb
+' visual_basic_style_unused_value_expression_statement_preference = unused_local_variable:silent
+
+Dim unused = Computation()
+```
+
+#### visual_basic_style_unused_value_assignment_preference
+
+|||
+|-|-|
+| **Rule name** | visual_basic_style_unused_value_assignment_preference |
+| **Rule ID** | IDE0059 |
+| **Applicable languages** | Visual Basic |
+| **Values** | `unused_local_variable:silent` |
+| **Visual Studio default** | `unused_local_variable:silent` |
+
+Code examples:
+
+```vb
+' visual_basic_style_unused_value_assignment_preference = unused_local_variable:suggestion
+
+Dim unused = Computation()
+Dim x = 1;
+```
+
 #### dotnet_style_readonly_field
 
 |||
@@ -935,6 +972,7 @@ These rules could appear in an *.editorconfig* file as follows:
 [*.{cs,vb}]
 dotnet_style_coalesce_expression = true:suggestion
 dotnet_style_null_propagation = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
 ```
 
 #### dotnet\_style\_coalesce_expression
@@ -997,6 +1035,16 @@ Dim v = If(o Is Nothing, Nothing, o.ToString()) ' or
 Dim v = If(o IsNot Nothing, o.ToString(), Nothing)
 ```
 
+### dotnet\_style\_prefer\_is\_null\_check\_over\_reference\_equality\_method
+
+|||
+|-|-|
+| **Rule name** | dotnet_style_prefer_is_null_check_over_reference_equality_method |
+| **Rule ID** | IDE0041 |
+| **Applicable languages** | C# 6.0+ and Visual Basic 14+ |
+| **Values** | `true` - Prefer is null check over reference equality method<br /><br />`false` - Prefer reference equality method over is null check |
+| **Visual Studio default** | `true:silent` |
+
 ## .NET code quality settings
 
 The quality rules in this section apply to both C# and Visual Basic code. They're used to configure code analyzers that are built into the Visual Studio integrated development environment (IDE). For information about configuring FxCop analyzers with an EditorConfig file, see [Configure FxCop analyzers](../code-quality/configure-fxcop-analyzers.md).
@@ -1075,6 +1123,8 @@ The style rules in this section are applicable to C# only.
 - ["Null" checking preferences](#c-null-checking-preferences)
   - csharp\_style\_throw_expression
   - csharp\_style\_conditional\_delegate_call
+- [Modifier preferences](#normalize-modifiers)
+  -csharp\_preferred\_modifier_order
 - [Code block preferences](#code-block-preferences)
   - csharp\_prefer_braces
 - [Unused value preferences](#unused-value-preferences)

docs/ide/editorconfig-naming-conventions.md

@@ -1,12 +1,12 @@
 ---
 title: .NET Naming Conventions For EditorConfig files
-ms.date: 08/07/2019
+ms.date: 03/31/2020
 ms.topic: reference
 helpviewer_keywords:
 - naming conventions [EditorConfig]
 - EditorConfig naming conventions
-author: TerryGLee
-ms.author: tglee
+author: mikadumont
+ms.author: midumont
 manager: jillfra
 ms.workload:
 - multiple
@@ -51,6 +51,8 @@ The following list shows the allowable values, and you can specify multiple valu
 - local
 - local_function
 
+[!NOTE] Tuple members aren't currently supported.
+
 ### Accessibility levels of symbols
 
 To describe the accessibility levels of the symbols you want the naming rule to apply to, specify a property name in the following format: