diff --git a/src/Microsoft.AspNetCore.Razor.Language/RazorParserOptions.cs b/src/Microsoft.AspNetCore.Razor.Language/RazorParserOptions.cs
index 3b3a923130..dcf64998d1 100644
--- a/src/Microsoft.AspNetCore.Razor.Language/RazorParserOptions.cs
+++ b/src/Microsoft.AspNetCore.Razor.Language/RazorParserOptions.cs
@@ -38,6 +38,14 @@ namespace Microsoft.AspNetCore.Razor.Language
 
         public abstract IReadOnlyCollection<DirectiveDescriptor> Directives { get; }
 
+        /// <summary>
+        /// Gets a value which indicates whether the parser will parse only the leading directives. If <c>true</c>
+        /// the parser will halt at the first HTML content or C# code block. If <c>false</c> the whole document is parsed.
+        /// </summary>
+        /// <remarks>
+        /// Currently setting this option to <c>true</c> will result in only the first line of directives being parsed.
+        /// In a future release this may be updated to include all leading directive content.
+        /// </remarks>
         public abstract bool ParseOnlyLeadingDirectives { get; }
     }
 }