diff --git a/docs/rules/1025.md b/docs/rules/1025.md index 94e7bb34..b952cd46 100644 --- a/docs/rules/1025.md +++ b/docs/rules/1025.md @@ -2,7 +2,8 @@ **Description**: Checks whether an existing property's `required` status is changed from the previous specification. -**Cause**: This is considered a breaking change in the same api-version but not breaking in new api-version . +**Cause**: Changing an existing property's `required` status is a breaking change in the same api-version. +In a new api-version, whether the change is breaking depends on its impact on the wire contract and Azure REST API breaking-change policy. **Example**: `required` status for parameter `b` is changed from `false` to `true` without revising api-version.