Apply suggestions from code review

Co-authored-by: Si Beaumont <[email protected]>

Sources/_OpenAPIGeneratorCore/Config.swift

@@ -17,15 +17,11 @@ public enum NamingStrategy: String, Sendable, Codable, Equatable {
 
     /// A defensive strategy that can handle any OpenAPI identifier and produce a non-conflicting Swift identifier.
     ///
-    /// This strategy is the default in Swift OpenAPI Generator 1.x.
-    ///
     /// Introduced in [SOAR-0001](https://swiftpackageindex.com/apple/swift-openapi-generator/documentation/swift-openapi-generator/soar-0001).
     case defensive
 
     /// An idiomatic strategy that produces Swift identifiers that more likely conform to Swift conventions.
     ///
-    /// Opt-in since Swift OpenAPI Generator 1.6.0.
-    ///
     /// Introduced in [SOAR-0013](https://swiftpackageindex.com/apple/swift-openapi-generator/documentation/swift-openapi-generator/soar-0013).
     case idiomatic
 }

Sources/swift-openapi-generator/Documentation.docc/Articles/Configuring-the-generator.md

@@ -40,9 +40,9 @@ The configuration file has the following keys:
     - `tags`: Operations tagged with these tags will be included in the filter.
     - `paths`: Operations for these paths will be included in the filter.
     - `schemas`: These (additional) schemas will be included in the filter.
-- `namingStrategy` (optional): a string. Customizes the strategy of converting OpenAPI identifiers into Swift identifiers.
+- `namingStrategy` (optional): a string. The strategy of converting OpenAPI identifiers into Swift identifiers.
     - `defensive` (default): Produces non-conflicting Swift identifiers for any OpenAPI identifiers. Check out [SOAR-0001](https://swiftpackageindex.com/apple/swift-openapi-generator/documentation/swift-openapi-generator/soar-0001) for details.
-    - `idiomatic`: Produces more idiomatic Swift identifiers for OpenAPI identifiers, might produce name conflicts (in that case, switch back to `defensive`.) Check out [SOAR-0013](https://swiftpackageindex.com/apple/swift-openapi-generator/documentation/swift-openapi-generator/soar-0013) for details.
+    - `idiomatic`: Produces more idiomatic Swift identifiers for OpenAPI identifiers. Might produce name conflicts (in that case, switch back to `defensive`). Check out [SOAR-0013](https://swiftpackageindex.com/apple/swift-openapi-generator/documentation/swift-openapi-generator/soar-0013) for details.
 - `nameOverrides` (optional): a string to string dictionary. Allows customizing how individual OpenAPI identifiers get converted to Swift identifiers.
 - `featureFlags` (optional): array of strings. Each string must be a valid feature flag to enable. For a list of currently supported feature flags, check out [FeatureFlags.swift](https://github.com/apple/swift-openapi-generator/blob/main/Sources/_OpenAPIGeneratorCore/FeatureFlags.swift).