Change docs

Author: rambleraptor

docs/rules/0004/resource-reference-type.md

@@ -33,9 +33,7 @@ message Book {
   string path = 1;
 
   // This is not a resource reference; the annotation does not belong.
-  Author author = 2 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Author"
-  }];
+  Author author = 2 [(aep.api.field_info).resource_reference = "library.googleapis.com/Author"];
 }
 ```
 
@@ -55,9 +53,7 @@ message Book {
 message Book {
   string path = 1;
 
-  string author = 2 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Author"
-  }];
+  string author = 2 [(aep.api.field_info).resource_reference = "library.googleapis.com/Author"];
 }
 ```
 

docs/rules/0121/no-mutable-cycles.md

@@ -33,7 +33,7 @@ message Book {
 
   // Incorrect. Creates potential reference cycle.
   string author = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Author"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Author"
   ];
 }
 
@@ -47,7 +47,7 @@ message Author {
 
   // Incorrect. Creates potential reference cycle.
   string book = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -65,7 +65,7 @@ message Book {
 
   // Correct because the other reference is OUTPUT_ONLY.
   string author = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Author"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Author"
   ];
 }
 
@@ -79,7 +79,7 @@ message Author {
 
   // Correct because an OUTPUT_ONLY reference breaks the mutation cycle.
   string book = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book",
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book",
     (aep.api.field_behavior) = FIELD_BEHAVIOR_OUTPUT_ONLY
   ];
 }
@@ -102,7 +102,7 @@ message Book {
   // (-- api-linter: core::0121::no-mutable-cycles=disabled
   //     aep.dev/not-precedent: We need to do this because reasons. --)
   string author = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Author"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Author"
   ];
 }
 
@@ -117,7 +117,7 @@ message Author {
   // (-- api-linter: core::0121::no-mutable-cycles=disabled
   //     aep.dev/not-precedent: We need to do this because reasons. --)
   string book = 2 [
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```

docs/rules/0122/resource-reference-type.md

@@ -28,9 +28,7 @@ message Book {
   string path = 1;
 
   // Resource references should be strings.
-  Author author = 2 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Author"
-  }];
+  Author author = 2 [(aep.api.field_info).resource_reference = "library.googleapis.com/Author"];
 }
 ```
 
@@ -41,9 +39,7 @@ message Book {
 message Book {
   string path = 1;
 
-  string author = 2 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Author"
-  }];
+  string author = 2 [(aep.api.field_info).resource_reference = "library.googleapis.com/Author"];
 }
 ```
 
@@ -69,9 +65,7 @@ message Book {
 
   // (-- api-linter: core::0122::resource-reference-type=disabled
   //     aep.dev/not-precedent: We need to do this because reasons. --)
-  Author author = 2 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Author"
-  }];
+  Author author = 2 [(aep.api.field_info).resource_reference = "library.googleapis.com/Author"];
 }
 ```
 

docs/rules/0124/reference-same-package.md

@@ -46,9 +46,7 @@ message Book {
 package google.example.libray.v1;  // Typo: Different package.
 
 message GetBookRequest {
-  string name = 1 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Book"  // Lint warning: package mismatch.
-  }];
+  string name = 1 [(aep.api.field_info).resource_reference = "library.googleapis.com/Book"];  // Lint warning: package mismatch.
 }
 ```
 
@@ -70,9 +68,7 @@ message Book {
 }
 
 message GetBookRequest {
-  string name = 1 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Book"
-  }];
+  string name = 1 [(aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 }
 ```
 
@@ -98,9 +94,7 @@ package google.example.library.v1;
 message GetBookRequest {
   // (-- api-linter: core::0124::reference-same-package=disabled
   //     aep.dev/not-precedent: We need to do this because reasons. --)
-  string name = 1 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Book"
-  }];
+  string name = 1 [(aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 }
 ```
 

docs/rules/0127/http-template-pattern.md

@@ -36,7 +36,7 @@ rpc GetBook(GetBookRequest) returns (Book) {
 }
 message GetBookRequest {
     string path = 1 [
-        (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+        (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
     ];
 }
 message Book {
@@ -61,7 +61,7 @@ rpc GetBook(GetBookRequest) returns (Book) {
 }
 message GetBookRequest {
     string path = 1 [
-        (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+        (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
     ];
 }
 message Book {

docs/rules/0131/request-path-behavior.md

@@ -29,9 +29,7 @@ value of `FIELD_BEHAVIOR_REQUIRED`.
 // Incorrect.
 message GetBookRequest {
   // The `aep.api.field_behavior` annotation should also be included.
-  string path = 1 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Book"
-  }];
+  string path = 1 [(aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 }
 ```
 
@@ -42,7 +40,7 @@ message GetBookRequest {
 message GetBookRequest {
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -56,9 +54,7 @@ Remember to also include an [aep.dev/not-precedent][] comment explaining why.
 message GetBookRequest {
   // (-- api-linter: core::0131::request-path-behavior=disabled
   //     aep.dev/not-precedent: We need to do this because reasons. --)
-  string path = 1 [(aep.api.field_info).resource_reference = {
-    type: "library.googleapis.com/Book"
-  }];
+  string path = 1 [(aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 }
 ```
 

docs/rules/0131/request-path-reference-type.md

@@ -33,7 +33,7 @@ message GetBookRequest {
   // reference.
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.child_type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference_child_type = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -45,7 +45,7 @@ message GetBookRequest {
 message GetBookRequest {
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -61,7 +61,7 @@ message GetBookRequest {
   //     aep.dev/not-precedent: We need to do this because reasons. --)
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.child_type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference_child_type = "library.googleapis.com/Book"
   ];
 }
 ```

docs/rules/0131/request-path-reference.md

@@ -39,7 +39,7 @@ message GetBookRequest {
 message GetBookRequest {
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```

docs/rules/0131/request-path-required.md

@@ -27,7 +27,7 @@ the `path` field is missing.
 message GetBookRequest {
   string book = 1 [  // Field path should be `path`.
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -39,7 +39,7 @@ message GetBookRequest {
 message GetBookRequest {
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```
@@ -55,7 +55,7 @@ Remember to also include an [aep.dev/not-precedent][] comment explaining why.
 message GetBookRequest {
   string book = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference.type = "library.googleapis.com/Book"
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"
   ];
 }
 ```

docs/rules/0131/request-required-fields.md

@@ -31,9 +31,7 @@ message GetBookRequest {
   // Format: publishers/{publisher}/books/{book}
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference = {
-      type: "library.googleapis.com/Book"
-  }];
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 
   // Non-standard required field.
    google.protobuf.FieldMask read_mask = 2 [(aep.api.field_info).field_behavior = FIELD_BEHAVIOR_REQUIRED];
@@ -49,9 +47,7 @@ message GetBookRequest {
   // Format: publishers/{publisher}/books/{book}
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference = {
-      type: "library.googleapis.com/Book"
-  }];
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 
   google.protobuf.FieldMask read_mask = 2 [(aep.api.field_info).field_behavior = OPTIONAL];
 }
@@ -68,9 +64,7 @@ message GetBookRequest {
   // Format: publishers/{publisher}/books/{book}
   string path = 1 [
     (aep.api.field_behavior) = FIELD_BEHAVIOR_REQUIRED,
-    (aep.api.field_info).resource_reference = {
-      type: "library.googleapis.com/Book"
-  }];
+    (aep.api.field_info).resource_reference = "library.googleapis.com/Book"];
 
   // (-- api-linter: core::0131::request-required-fields=disabled
   //     aep.dev/not-precedent: We really need this field to be required because