Index: Ringtoets/Common/src/Ringtoets.Common.IO/Readers/CombinedXmlSchemaDefinition.cs =================================================================== diff -u -r7683c48cab2de71c7e6e3960f43d491660a4b552 -r1d2bc8f06f058cf7bf75fffa684ceca7961ec1de --- Ringtoets/Common/src/Ringtoets.Common.IO/Readers/CombinedXmlSchemaDefinition.cs (.../CombinedXmlSchemaDefinition.cs) (revision 7683c48cab2de71c7e6e3960f43d491660a4b552) +++ Ringtoets/Common/src/Ringtoets.Common.IO/Readers/CombinedXmlSchemaDefinition.cs (.../CombinedXmlSchemaDefinition.cs) (revision 1d2bc8f06f058cf7bf75fffa684ceca7961ec1de) @@ -32,8 +32,7 @@ namespace Ringtoets.Common.IO.Readers { /// - /// Container for one or more related/nested schema definitions, representing a combined - /// XML Schema Definition (XSD). + /// Container for related/nested schema definitions, representing a combined XML Schema Definition (XSD). /// public class CombinedXmlSchemaDefinition { @@ -42,11 +41,11 @@ /// /// Creates a new instance of . /// - /// A string representing the main schema definition. + /// A string representing the main schema definition. /// A containing - /// one or more nested schema definitions; the keys should represent unique file names by which - /// the schema definitions can be referenced from , the - /// values should represent the corresponding schema definition strings. + /// zero to more nested schema definitions. The keys should represent unique file names by which + /// the schema definitions can be referenced from ; the + /// values should represent their corresponding schema definition string. /// Thrown when /// is null. /// Thrown when: @@ -90,9 +89,9 @@ /// /// Check the provided schema definitions for not being null, empty or only containing white spaces. /// - /// A string representing the main schema definition. + /// A string representing the main schema definition. /// A containing - /// one or more nested schema definitions. + /// zero to more nested schema definitions. /// Thrown when /// is null. /// Thrown when: @@ -115,14 +114,14 @@ if (nestedSchemaDefinitions.Values.Any(string.IsNullOrWhiteSpace)) { - throw new ArgumentException($"'{nameof(nestedSchemaDefinitions)}' holds a nested schema definition value that equals null, is empty or only contains white spaces."); + throw new ArgumentException($"'{nameof(nestedSchemaDefinitions)}' contains one or more nested schema definitions that equal null, are empty or only contain white spaces."); } } /// - /// Compiles the based on the provided main schema definition string. + /// Compiles the based on the provided main schema definition. /// - /// A string representing the main schema definition. + /// A string representing the main schema definition. /// Thrown when , /// all together with its referenced nested schema definitions, contains an invalid schema /// definition. @@ -136,7 +135,7 @@ catch (Exception exception) when (exception is XmlException || exception is XmlSchemaException) { - throw new ArgumentException($"'{nameof(mainSchemaDefinition)}' containing invalid schema definition: {exception.Message}", exception); + throw new ArgumentException($"'{nameof(mainSchemaDefinition)}' invalid: {exception.Message}", exception); } } @@ -152,7 +151,7 @@ /// Creates a new instance of . /// /// A containing - /// one or more nested schema definitions. + /// zero to more nested schema definitions. public NestedSchemaDefinitionsResolver(IDictionary nestedSchemaDefinitions) { this.nestedSchemaDefinitions = nestedSchemaDefinitions; @@ -168,7 +167,7 @@ } /// - /// Gets whether or not all nested schema definitions are used. + /// Gets whether all nested schema definitions are used. /// public bool AllNestedSchemaDefinitionsReferenced {