diff --git a/src/Microsoft.AspNetCore.Mvc.Core/CompatibilityVersion.cs b/src/Microsoft.AspNetCore.Mvc.Core/CompatibilityVersion.cs
index ad18d058a6..aa63713383 100644
--- a/src/Microsoft.AspNetCore.Mvc.Core/CompatibilityVersion.cs
+++ b/src/Microsoft.AspNetCore.Mvc.Core/CompatibilityVersion.cs
@@ -51,10 +51,13 @@ namespace Microsoft.AspNetCore.Mvc
///
/// ASP.NET Core MVC 2.1 introduces compatibility switches for the following:
///
+ ///
+ ///
///
///
/// - MvcJsonOptions.AllowInputFormatterExceptionMessages
/// - RazorPagesOptions.AllowAreas
+ /// - RazorPagesOptions.AllowMappingHeadRequestsToGetHandler
///
///
Version_2_1,
@@ -66,7 +69,15 @@ namespace Microsoft.AspNetCore.Mvc
///
/// ASP.NET Core MVC 2.2 introduces compatibility switches for the following:
///
+ /// - ApiBehaviorOptions.SuppressMapClientErrors
+ /// - ApiBehaviorOptions.SuppressUseValidationProblemDetailsForInvalidModelStateResponses
/// - MvcDataAnnotationsLocalizationOptions.AllowDataAnnotationsLocalizationForEnumDisplayAttributes
+ ///
+ ///
+ /// - RazorPagesOptions.AllowDefaultHandlingForOptionsRequests
+ /// - RazorViewEngineOptions.AllowRecompilingViewsOnFileChange
+ /// - MvcViewOptions.AllowRenderingMaxLengthAttribute
+ /// - MvcXmlOptions.AllowRfc7807CompliantProblemDetailsFormat
///
///
Version_2_2,