feat(122, oas): clarify parent field usage

AEP-122 only has guidance on the parent path for proto.
Adding OAS guidance to reduce confusion.

Fixes #325

Author: toumorokoshi

aep/general/0122/aep.md.j2

@@ -237,6 +237,8 @@ example: `file_path`).
 
 ### Fields representing a resource's parent
 
+{% tab proto %}
+
 When defining a method that retrieves resources from a collection or adds a new
 resource to a collection (such as `ListBooks` or `CreateBook`), the first field
 of the request message **should** be of type `string` and **should** be called
@@ -281,6 +283,36 @@ string parent = 1 [
 **Note:** Fields **should not** be called `parent` except for this purpose. For
 other use cases, use a synonymous term if possible.
 
+{% tab oas %}
+
+For HTTP APIs, the parent is determined from the HTTP path of the resource. For
+example, for the following book:
+
+```
+http://api.example.com/publishers/123/books/les-miserables
+```
+
+`publishers/123` is the parent resource. For any use cases in which the parent
+is needed, they may be extracted from the HTTP path by removing the collection
+and id suffix of the path (`books/les-miserables`) in the case above.
+
+{% endtabs %}
+
+{% tab oas %}
+
+For HTTP APIs, the parent is determined from the HTTP path of the resource. For
+example, for the following book:
+
+```
+http://api.example.com/publishers/123/books/les-miserables
+```
+
+`publishers/123` is the parent resource. For any use cases in which the parent
+is needed, they may be extracted from the HTTP path by removing the collection
+and id suffix of the path (`books/les-miserables`) in the case above.
+
+{% endtabs %}
+
 ### Fields representing another resource
 
 When referencing a resource path for a different resource, the field **should**

aep/general/0155/aep.md.j2

@@ -48,13 +48,10 @@ message CreateBookRequest {
 
 - [`aep.api.IdempotencyKey`][IdempotencyKey] has a `key` and a `first_sent`
   timestamp.
-
   - `key` is simply a unique identifier.
 
 - Providing an idempotency key **must** guarantee idempotency.
-
   - If a duplicate request is detected, the server **must** return one of:
-
     - A response equivalent to the response for the previously successful
       request, because the client most likely did not receive the previous
       response.
@@ -75,7 +72,6 @@ message CreateBookRequest {
 
 - The `idempotency_key` field **must** be provided on the request message to
   which it applies (and it **must not** be a field on resources themselves).
-
   - The `first_sent` field can be used by API servers to determine if a key is
     expired. API servers **must** reject requests with expired keys, and
     **must** reject requests with keys that are in the future. When feasible,