diff --git a/src/Microsoft.AspNetCore.Razor.Language/DirectiveUsage.cs b/src/Microsoft.AspNetCore.Razor.Language/DirectiveUsage.cs
index 5af9311748..df00a6c71b 100644
--- a/src/Microsoft.AspNetCore.Razor.Language/DirectiveUsage.cs
+++ b/src/Microsoft.AspNetCore.Razor.Language/DirectiveUsage.cs
@@ -3,9 +3,20 @@
 
 namespace Microsoft.AspNetCore.Razor.Language
 {
+    /// <summary>
+    /// The way a directive can be used. The usage determines how many, and where directives can exist per file.
+    /// </summary>
     public enum DirectiveUsage
     {
+        /// <summary>
+        /// Directive can exist anywhere in the file.
+        /// </summary>
         Unrestricted,
+
+        /// <summary>
+        /// Directive must exist prior to any HTML or code and have no duplicates. When importing the directive, if it is 
+        /// <see cref="DirectiveKind.SingleLine"/>, the last occurrence of the directive is imported.
+        /// </summary>
         FileScopedSinglyOccurring,
     }
 }