Merge branch 'main' into add-email-return-path

CHANGELOG.next.md

@@ -44,6 +44,7 @@ Thanks, you're awesome :-) -->
 
 * Add `service.node.role` #1916
 * Add `email.return_path.address` #1947
+* Initial set of `expected_values`. #1962
 
 #### Improvements
 
@@ -59,8 +60,12 @@ Thanks, you're awesome :-) -->
 
 #### Added
 
+* Introduce `expected_values` attribute. #1952
+
 #### Improvements
 
+* Additional type annotations. #1950
+
 #### Deprecated
 
 ## 8.3.0 (Hard Feature Freeze)

USAGE.md

@@ -416,6 +416,7 @@ Strict mode requires the following conditions, else the script exits on an excep
 * Short descriptions must be less than or equal to 120 characters.
 * Example values containing arrays or objects must be quoted to avoid unexpected YAML interpretation when the schema files or artifacts are relied on downstream.
 * If a regex `pattern` is defined, the example values will be checked against it.
+* If `expected_values` is defined, the example value(s) will be checked against the list.
 
 The current artifacts generated and published in the ECS repo will always be created using strict mode. However, older ECS versions (pre `v1.5.0`) will cause
 an exception if attempting to generate them using `--strict`. This is due to schema validation checks introduced after that version was released.