add file header decoration comments if configured

Author: zitzltho

StyleCop.Analyzers/StyleCop.Analyzers.CodeFixes/DocumentationRules/FileHeaderCodeFixProvider.cs

@@ -365,10 +365,20 @@ private static string WrapInXmlComment(string prefixWithLeadingSpaces, string co
             string encodedCompanyName = new XAttribute("t", settings.DocumentationRules.CompanyName).ToString().Substring(2).Trim('"');
             string encodedCopyrightText = new XText(copyrightText).ToString();
 
-            return
+            string copyrightString =
                 $"{prefixWithLeadingSpaces} <copyright file=\"{encodedFilename}\" company=\"{encodedCompanyName}\">" + newLineText
                 + encodedCopyrightText + newLineText
                 + prefixWithLeadingSpaces + " </copyright>";
+
+            if (!string.IsNullOrEmpty(settings.DocumentationRules.HeaderDecoration))
+            {
+                return
+                    $"{prefixWithLeadingSpaces} {settings.DocumentationRules.HeaderDecoration}" + newLineText
+                    + copyrightString + newLineText
+                    + $"{prefixWithLeadingSpaces} {settings.DocumentationRules.HeaderDecoration}";
+            }
+
+            return copyrightString;
         }
 
         private static string GetCopyrightText(string prefixWithLeadingSpaces, string copyrightText, string newLineText)

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

@@ -32,6 +32,12 @@ internal class DocumentationSettings
         [JsonProperty("copyrightText", DefaultValueHandling = DefaultValueHandling.Ignore)]
         private string copyrightText;
 
+        /// <summary>
+        /// This is the backing field for the <see cref="CompanyName"/> property.
+        /// </summary>
+        [JsonProperty("headerDecoration", DefaultValueHandling = DefaultValueHandling.Ignore)]
+        private string headerDecoration;
+
         /// <summary>
         /// This is the cache for the <see cref="CopyrightText"/> property.
         /// </summary>
@@ -94,6 +100,7 @@ protected internal DocumentationSettings()
             this.companyName = DefaultCompanyName;
             this.copyrightText = DefaultCopyrightText;
             this.variables = ImmutableDictionary<string, string>.Empty.ToBuilder();
+            this.headerDecoration = null;
             this.xmlHeader = true;
 
             this.documentExposedElements = true;
@@ -126,6 +133,14 @@ public string CopyrightText
             }
         }
 
+        public string HeaderDecoration
+        {
+            get
+            {
+                return this.headerDecoration;
+            }
+        }
+
         public ImmutableDictionary<string, string> Variables
         {
             get