Add DocumentationSettings.DocumentationCulture option

Author: Christian Käser

StyleCop.Analyzers/StyleCop.Analyzers/Settings/ObjectModel/DocumentationSettings.cs

@@ -21,6 +21,11 @@ internal class DocumentationSettings
         /// </summary>
         internal const string DefaultCopyrightText = "Copyright (c) {companyName}. All rights reserved.";
 
+        /// <summary>
+        /// The default value for the <see cref="DocumentationCulture"/> property.
+        /// </summary>
+        internal const string DefaultDocumentationCulture = "en-US";
+
         /// <summary>
         /// This is the backing field for the <see cref="CompanyName"/> property.
         /// </summary>
@@ -92,6 +97,12 @@ internal class DocumentationSettings
         [JsonProperty("fileNamingConvention", DefaultValueHandling = DefaultValueHandling.Include)]
         private FileNamingConvention fileNamingConvention;
 
+        /// <summary>
+        /// This is the backing field for the <see cref="DocumentationCulture"/> property.
+        /// </summary>
+        [JsonProperty("documentationCulture", DefaultValueHandling = DefaultValueHandling.Include)]
+        private string documentationCulture;
+
         /// <summary>
         /// Initializes a new instance of the <see cref="DocumentationSettings"/> class during JSON deserialization.
         /// </summary>
@@ -110,6 +121,8 @@ protected internal DocumentationSettings()
             this.documentInterfaces = true;
             this.documentPrivateFields = false;
 
+            this.documentationCulture = DefaultDocumentationCulture;
+
             this.fileNamingConvention = FileNamingConvention.StyleCop;
         }
 
@@ -163,6 +176,9 @@ public bool XmlHeader
         public FileNamingConvention FileNamingConvention =>
             this.fileNamingConvention;
 
+        public string DocumentationCulture =>
+            this.documentationCulture;
+
         public string GetCopyrightText(string fileName)
         {
             string copyrightText = this.copyrightTextCache;

StyleCop.Analyzers/StyleCop.Analyzers/Settings/stylecop.schema.json

@@ -204,6 +204,11 @@
               "description": "Specifies the preferred naming convention for files. The default value \"stylecop\" uses the naming convention defined by StyleCop Classic, while \"metadata\" uses a file naming convention that matches the metadata names of types.",
               "default": "stylecop",
               "enum": [ "stylecop", "metadata" ]
+            },
+            "documentationCulture": {
+                "type": "string",
+                "description": "The culture that should be used for documentation comments.",
+                "default": "en-US"
             }
           }
         }