Add rule documentation for R1041 (Azure#161)

* add 1041

* update

* update pipeline

Author: jianyexi

azure-pipelines.yml

@@ -20,11 +20,11 @@ steps:
   inputs:
     pathtoPublish: $(Build.SourcesDirectory)/drop
 
-- task: CredScan@2
+- task: securedevelopmentteam.vss-secure-development-tools.build-task-credscan.CredScan@2 # CredScan@2
   inputs:
     toolMajorVersion: 'V2'
 
-- task: PostAnalysis@1
+- task: securedevelopmentteam.vss-secure-development-tools.build-task-postanalysis.PostAnalysis@1 # PostAnalysis@1
   inputs:
     AllTools: false
     APIScan: false

docs/rules/1041.md

@@ -0,0 +1,97 @@
+### 1041 - AddedPropertyInResponse
+
+**Description**: Checks whether a property is added to the response model from the previous specification.
+
+**Cause**: This is considered a breaking change.
+
+**Example**: Property `c` is being added into model `Parameters` from response direction.
+
+Old specification
+```json5
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "swagger",
+    "description": "The Azure Management API.",
+    "version": "2016-12-01",
+    ...
+    ...
+  "paths:" {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1": {
+      "get": {
+        ...
+        "responses": {
+          "200": {
+            "schema": {
+              "$ref": "#/definitions/Parameters"
+            }
+          }
+        }
+      }
+  }
+  "definitions": {
+    ...
+    ...
+    "Parameters": {
+      "properties": {
+        "a": {
+          "type": "string",
+          "description": "Required. Property a."
+        },
+        "b": {
+          "type": "string",
+          "description": "Required. Enum Property b.",
+          "enum": [ "b1", "b2" ]
+        }
+      },
+      "description": "The parameters used when get operation."
+    },
+    ...  
+```
+
+New specification
+```json5
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "swagger",
+    "description": "The Azure Management API.",
+    "version": "2016-12-01",
+    ...
+    ...
+  "paths:" {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Contoso/resource1": {
+      "get": {
+        ...
+        "responses": {
+          "200": {
+            "schema": {
+              "$ref": "#/definitions/Parameters"
+            }
+          }
+        }
+      }
+  }
+  "definitions": {
+    ...
+    ...
+    "Parameters": {
+      "properties": {
+        "a": {
+          "type": "string",
+          "description": "Required. Property a."
+        },
+        "b": {
+          "type": "string",
+          "description": "Required. Enum Property b.",
+          "enum": [ "b1", "b2" ]
+        },
+        "c": {
+          "type": "string",
+          "description": "Read Only. Property c."
+        }
+      },
+      "description": "The parameters used when get operation."
+    },
+    ...  
+```