.

Author: SimonCropp

src/Microsoft.OpenApi/Models/OpenApiSecurityScheme.cs

@@ -205,7 +205,7 @@ public void SerializeAsV2WithoutReference(IOpenApiWriter writer)
                     break;
 
                 case SecuritySchemeType.OAuth2:
-                    // These properties apply to ouauth2 type only.
+                    // These properties apply to oauth2 type only.
                     // flow
                     // authorizationUrl
                     // tokenUrl

src/Microsoft.OpenApi/Services/OpenApiUrlTreeNode.cs

@@ -242,7 +242,7 @@ public void WriteMermaid(TextWriter writer)
         }
 
         /// <summary>
-        /// Dictionary that maps a set of HTTP methods to HTML color.  Keys are sorted, uppercased, concatenated HTTP methods.
+        /// Dictionary that maps a set of HTTP methods to HTML color.  Keys are sorted, upper-cased, concatenated HTTP methods.
         /// </summary>
         public readonly static IReadOnlyDictionary<string, MermaidNodeStyle> MermaidNodeStyles = new Dictionary<string, MermaidNodeStyle>(StringComparer.OrdinalIgnoreCase)
         {

src/Microsoft.OpenApi/Validations/Rules/OpenApiMediaTypeRules.cs

@@ -12,7 +12,7 @@ namespace Microsoft.OpenApi.Validations.Rules
     /// Removed this in v1.3 as a default rule as the OpenAPI specification does not require that example
     /// values validate against the schema.  Validating examples against the schema is particularly difficult
     /// as it requires parsing of the example using the schema as a guide.  This is not possible when the schema
-    /// is ref'd.  Even if we fix this issue, this rule should be treated as a warning, not an error
+    /// is referenced.  Even if we fix this issue, this rule should be treated as a warning, not an error
     /// Future versions of the validator should make that distinction.
     /// Future versions of the example parsers should not try an infer types.
     /// Example validation should be done as a separate post reading step so all schemas can be fully available.

src/Microsoft.OpenApi/Validations/ValidationRuleSet.cs

@@ -38,8 +38,8 @@ public IList<ValidationRule> FindRules(Type type)
         /// Gets the default validation rule sets.
         /// </summary>
         /// <remarks>
-        /// This is a method instead of a property to signal that a new default ruleset object is created
-        /// per call. Making this a property may be misleading callers to think the returned rulesets from multiple calls
+        /// This is a method instead of a property to signal that a new default rule-set object is created
+        /// per call. Making this a property may be misleading callers to think the returned rule-sets from multiple calls
         /// are the same objects.
         /// </remarks>
         public static ValidationRuleSet GetDefaultRuleSet()
@@ -56,7 +56,7 @@ public static ValidationRuleSet GetDefaultRuleSet()
         }
 
         /// <summary>
-        /// Return Ruleset with no rules
+        /// Return <see cref="ValidationRuleSet"/> with no rules
         /// </summary>
         public static ValidationRuleSet GetEmptyRuleSet()
         {