Add documentation for ide0130 (#32885)

Author: Andrew Hall

docs/fundamentals/code-analysis/style-rules/ide0130.md

@@ -0,0 +1,130 @@
+---
+title: "IDE0130: Namespace does not match folder structure"
+description: "Learn about code analysis rule IDE0130: Namespace does not match folder structure"
+ms.date: 12/05/2022
+ms.topic: reference
+f1_keywords:
+- IDE0130
+- dotnet_style_namespace_match_folder
+helpviewer_keywords:
+- IDE0130
+- dotnet_style_namespace_match_folder
+author: gewarren
+ms.author: gewarren
+dev_langs:
+- CSharp
+- VB
+---
+# Namespace does not match folder structure (IDE0130)
+
+| Property                 | Value                                                  |
+| ------------------------ | ------------------------------------------------------ |
+| **Rule ID**              | IDE0130                                                |
+| **Title**                | Namespace does not match folder structure              |
+| **Category**             | Style                                                  |
+| **Subcategory**          | Language rules (Namespace naming preferences)          |
+| **Applicable languages** | C# and Visual Basic                                    |
+| **Options**              | `dotnet_style_namespace_match_folder`                  |
+
+## Overview
+
+This style rule uses the folder structure of the project to enforce namespace naming requirements.
+
+## Options
+
+Options specify the behavior that you want the rule to enforce. For information about configuring options, see [Option format](language-rules.md#option-format).
+
+### dotnet_style_namespace_match_folder
+
+| Property                 | Value                                                | Description                                        |
+| ------------------------ | ---------------------------------------------------- | -------------------------------------------------- |
+| **Option name**          | dotnet_style_namespace_match_folder                  |                                                    |
+| **Option values**        | `true`                                               | Prefer namespace naming to match folder structure. |
+|                          | `false`                                              | Disables the rule.                                 |
+| **Default option value** | `true`                                               |                                                    |
+
+> [!NOTE]
+> The `dotnet_style_namespace_match_folder` option depends on knowing the current project and root namespace properties. This information is provided by Visual Studio but is not available for command-line builds, such as `dotnet build`. For command-line builds to work, you must add the following properties to your *.editorconfig* file and replace the root directory and namespace placeholders with your values:
+>
+> ```ini
+> is_global=true
+> build_property.ProjectDir = <root directory>
+> build_property.RootNamespace = <root namespace>
+> ```
+
+## Example
+
+Assume that the following code snippets are from a file named `Data/Example.cs` or `Data/Example.vb`, where `Data` represents the folder structure from the project file. The folder structure naming is added to the root namespace, which in this example is `Root`.
+
+```csharp
+// Code with violations
+namespace Root.BadExample
+{
+    class Example
+    {
+        public void M()
+        {
+        }
+    }
+}
+
+// Fixed code
+namespace Root.Data
+{
+    class Example
+    {
+        public void M()
+        {
+        }
+    }
+}
+```
+
+```vb
+' Code with violations
+Namespace Root.BadExample
+    Class Example
+        Public Sub M()
+        End Sub
+    End Class
+End Namespace
+
+' Fixed code
+Namespace Root.Data
+    Class Example
+        Public Sub M()
+        End Sub
+    End Class
+End Namespace
+```
+
+## Suppress a warning
+
+If you want to suppress only a single violation, add preprocessor directives to your source file to disable and then re-enable the rule.
+
+```csharp
+#pragma warning disable IDE0130
+// The code that's violating the rule is on this line.
+#pragma warning restore IDE0130
+```
+
+To disable the rule for a file, folder, or project, set its severity to `none` in the [configuration file](../configuration-files.md).
+
+```ini
+[*.{cs,vb}]
+dotnet_diagnostic.IDE0130.severity = none
+```
+
+To disable all of the code-style rules, set the severity for the category `Style` to `none` in the [configuration file](../configuration-files.md).
+
+```ini
+[*.{cs,vb}]
+dotnet_analyzer_diagnostic.category-Style.severity = none
+```
+
+For more information, see [How to suppress code analysis warnings](../suppress-warnings.md).
+
+## See also
+
+- [Language rules](language-rules.md)
+- [Code style rules reference](index.md)

docs/fundamentals/code-analysis/style-rules/index.md

@@ -119,6 +119,7 @@ The following table list all the code-style rules by ID and [options](../code-st
 > | [IDE0090](ide0090.md) | Simplify `new` expression | [csharp_style_implicit_object_creation_when_type_is_apparent](ide0090.md#csharp_style_implicit_object_creation_when_type_is_apparent) |
 > | [IDE0100](ide0100.md) | Remove unnecessary equality operator | |
 > | [IDE0110](ide0110.md) | Remove unnecessary discard | |
+> | [IDE0130](ide0130.md) | Namespace does not match folder structure | [dotnet_style_namespace_match_folder](ide0130.md#dotnet_style_namespace_match_folder) |
 > | [IDE0140](ide0140.md) | Simplify object creation | [visual_basic_style_prefer_simplified_object_creation](ide0140.md#visual_basic_style_prefer_simplified_object_creation) |
 > | [IDE0150](ide0150.md) | Prefer `null` check over type check | [csharp_style_prefer_null_check_over_type_check](ide0150.md#csharp_style_prefer_null_check_over_type_check) |
 > | [IDE0160](ide0160-ide0161.md) | Use block-scoped namespace | [csharp_style_namespace_declarations](ide0160-ide0161.md#csharp_style_namespace_declarations) |

docs/fundamentals/code-analysis/style-rules/language-rules.md

@@ -76,6 +76,7 @@ The style rules in this section are applicable to both C# and Visual Basic.
   - [Use null propagation (IDE0031)](ide0031.md)
   - [Use 'is null' check (IDE0041)](ide0041.md)
 - [File header preferences](ide0073.md)
+- [Namespace naming preferences](ide0130.md)
 
 ## C# style rules
 

docs/fundamentals/toc.yml

@@ -1678,6 +1678,10 @@ items:
             items:
             - name: IDE0073
               href: code-analysis/style-rules/ide0073.md
+          - name: Namespace naming preferences
+            items:
+            - name: IDE0130
+              href: code-analysis/style-rules/ide0130.md
         - name: Unnecessary code rules
           items:
           - name: Overview