From 5f2c00bc80849f5b61b6c76398d0d8df2eb745d9 Mon Sep 17 00:00:00 2001
From: "N. Taylor Mullen" <nimullen@microsoft.com>
Date: Mon, 26 Jun 2017 17:08:13 -0700
Subject: [PATCH] Add doc comments for `DirectiveUsage`.

---
 .../DirectiveUsage.cs                                 | 11 +++++++++++
 1 file changed, 11 insertions(+)

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,
     }
 }