Azure · jianyexi · Jul 21, 2022 · Jul 21, 2022 · Jul 26, 2022
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.9.7 Released on 2022-07-21
+
+- update documentation url.
+
 ## 0.9.6 Released on 2022-06-09
 
 - using autorest v3.6.1'.

diff --git a/docs/rules/1005.md b/docs/rules/1005.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing path is removed from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Path `/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1/subResource1` is being removed without revising api-version.
 

diff --git a/docs/rules/1006.md b/docs/rules/1006.md
@@ -2,8 +2,7 @@
 
 **Description**: Checks whether an existing model definition is removed from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
-
+**Cause**: This is considered a breaking change even in a new api-version.
 **Example**: Model definition `CreateParameters` is being removed without revising api-version.
 
 Old specification

diff --git a/docs/rules/1008.md b/docs/rules/1008.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing operation's `operationId` is changed from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: `operationId` of Operation `get` from Path `/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1` is being updated without revising api-version.
 

diff --git a/docs/rules/1009.md b/docs/rules/1009.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether required parameter is removed / made optional from the previous specification. 
 
-**Cause**: TBD.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Required parameter `c` is being removed without revising api-version.
 

diff --git a/docs/rules/1010.md b/docs/rules/1010.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether new required parameter is introduced from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: New required parameter `c` is introduced without revising api-version.
 

diff --git a/docs/rules/1019.md b/docs/rules/1019.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing enum property has removed allowed values from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Enum Property `b` is removing allowed values without revising api-version.
 

diff --git a/docs/rules/1020.md b/docs/rules/1020.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing enum property has added more allowed values from the previous specification. 
 
-**Cause**: This is considered a breaking change in the same api-version but not breaking in new api-version .
+**Cause**: This is considered a a breaking change. This change requires new api-version.
 
 **Example**: Enum Property `b` is adding more allowed values without revising api-version.
 

diff --git a/docs/rules/1023.md b/docs/rules/1023.md
@@ -2,7 +2,10 @@
 
 **Description**: Checks whether any existing property's [format](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#dataTypeFormat) element has changed from the previous specification.
 
-**Cause**: This is considered a breaking change in most cases except widening integer("int32" -> "int64") in request and narrowing integer ("int64" -> "int32") in response which are not breaking change in new api-version.
+**Cause**: This is considered a breaking change, exceptions in new api-version:
+ 1 widening integer("int32" -> "int64") in request  
+ 2 narrowing integer ("int64" -> "int32") in response .
+
 
 **Example**: Property `a` of Parameter `CreateParameters` changed format from `int64` to `int32` in the new version.
 

diff --git a/docs/rules/1025.md b/docs/rules/1025.md
@@ -2,7 +2,7 @@
 
 **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**: This is considered a a breaking change. This change requires new api-version. 
 
 **Example**: `required` status for parameter `b` is changed from `false` to `true` without revising api-version.
 

diff --git a/docs/rules/1026.md b/docs/rules/1026.md
@@ -2,8 +2,7 @@
 
 **Description**: Checks whether an existing property has changed the type from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
-
+**Cause**: This is considered a breaking change.
 **Example**: Property `b` is being changed from `string` to `boolean` without revising api-version.
 
 Old specification

diff --git a/docs/rules/1033.md b/docs/rules/1033.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing property is removed from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Property `c` is being removed without revising api-version.
 

diff --git a/docs/rules/1034.md b/docs/rules/1034.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether a new required property has added from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Property `b` is being added without revising api-version.
 

diff --git a/docs/rules/1035.md b/docs/rules/1035.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether an existing operation from a path is removed from the previous specification. 
 
-**Cause**: This is considered a breaking change. This change requires new api-version.
+**Cause**: This is considered a breaking change even in a new api-version.
 
 **Example**: Operation `get` from Path `/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1/subResource1` is being removed without revising api-version.
 

diff --git a/docs/rules/1038.md b/docs/rules/1038.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether a new path is added from the previous specification. 
 
-**Cause**: This is considered a additive change in new api-version but a breaking in same api-version.
+**Cause**: This is considered a a breaking change. This change requires new api-version.
 
 **Example**: New path `/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1/subResource1` is being added.
 

diff --git a/docs/rules/1039.md b/docs/rules/1039.md
@@ -2,7 +2,7 @@
 
 **Description**: Checks whether a new operation in an existing path is added from the previous specification. 
 
-**Cause**: This is considered a additive change in new api-version but a breaking in same api-version.
+**Cause**: This is considered a a breaking change. This change requires new api-version.
 
 **Example**: Operation `get` in Path `/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1/subResource1` is being added without revising api-version.
 

diff --git a/openapi-diff/src/modeler/AutoRest.Swagger/ComparisonMessage.cs b/openapi-diff/src/modeler/AutoRest.Swagger/ComparisonMessage.cs
@@ -16,7 +16,7 @@ namespace AutoRest.Swagger
     /// </summary>
     public class ComparisonMessage
     {
-        public static string DocBaseUrl = "https://github.com/Azure/openapi-diff/tree/master/docs/rules/";
+        public static string DocBaseUrl = "https://github.com/Azure/openapi-diff/tree/main/docs/rules/";
 
         public ComparisonMessage(
             MessageTemplate template,

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@azure/oad",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "author": {
     "name": "Microsoft Corporation",
     "email": "azsdkteam@microsoft.com",