Updating documentation (#3184)

* Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md * Update openapi-authoring-automated-guidelines.md
Azure · Jun 7, 2018 · e02b768 · e02b768
1 parent 709ef95
commit e02b768
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/documentation/openapi-authoring-automated-guidelines.md b/documentation/openapi-authoring-automated-guidelines.md
@@ -164,6 +164,8 @@ The date MAY optionally be followed by one of:
 Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
 
 ### <a name="R3014" />R3014 BodyPropertiesNamesCamelCase
+ Please refer to [R3016](#R3016)
+
 ### <a name="R3016" />R3016 DefinitionsPropertiesNamesCamelCase
 **Category** : ARM Error
 
@@ -1247,6 +1249,20 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
 
 ### <a name="R2024" />R2024 AnonymousBodyParameter
+**Category** : SDK Error
+
+**Applies to** : ARM specs
+
+**Output Message**: Inline/anonymous models must not be used, instead define a schema with a model name in the "definitions" section and refer to it. This allows operations to share the models.
+
+**Description**: This rule appears if in the parameter definition you have anonymous types. 
+
+**Why the rule is important**: Anonymous parameters will be autogenerated as non-descriptive parameters which the client will not be able to share across operations or provide good documentation for, thereby resulting in poor user experience.
+
+**How to fix the violation**: Move the schema to the definitions section and reference it using $ref.
+
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
 ### <a name="R2026" />R2026 AvoidAnonymousTypes
 **Category** : SDK Error