From 4db809f99b6b27ab2b3134c0b3164434eea9f3a2 Mon Sep 17 00:00:00 2001 From: Alex Stephen Date: Wed, 12 Nov 2025 14:48:01 -0800 Subject: [PATCH 1/3] Examples for 157 OAS --- aep/general/0157/aep.md.j2 | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/aep/general/0157/aep.md.j2 b/aep/general/0157/aep.md.j2 index 3aba2eee..94ae7eef 100644 --- a/aep/general/0157/aep.md.j2 +++ b/aep/general/0157/aep.md.j2 @@ -41,7 +41,17 @@ named `read_mask`. {% tab oas %} -**Note:** OAS example not yet written. +```yaml +parameters: + - in: query + name: fields + schema: + type: string + description: >- + A comma-separated list of fields to include in the response. If not + provided, all fields are returned. Nested fields can be specified using + dot notation. For example: `title,author.name`. +``` {% endtabs %} @@ -89,6 +99,18 @@ enum BookView { {% tab oas %} -**Note:** OAS example not yet written. +```yaml +parameters: + - in: query + name: view + schema: + type: string + enum: + - BASIC + - FULL + description: >- + Specifies which fields to return for the book. BASIC returns basic + metadata, FULL returns all fields. +``` -{% endtabs %} +{% endtab %} From de5300971cd8a2b77f750592aa89cf8e71aef328 Mon Sep 17 00:00:00 2001 From: Alex Stephen Date: Fri, 14 Nov 2025 12:17:46 -0800 Subject: [PATCH 2/3] Make changes --- aep/general/0157/aep.md.j2 | 2 ++ 1 file changed, 2 insertions(+) diff --git a/aep/general/0157/aep.md.j2 b/aep/general/0157/aep.md.j2 index 94ae7eef..1576785d 100644 --- a/aep/general/0157/aep.md.j2 +++ b/aep/general/0157/aep.md.j2 @@ -21,6 +21,8 @@ named `read_mask`. - An API **may** allow read masks with non-terminal repeated fields (unlike update masks), but is not obligated to do so. +List serialization / deserialization must conform to [RFC 9651](https://www.rfc-editor.org/rfc/rfc9651.html#name-serializing-a-list) + **Note:** Changing the default value of `read_mask` is a [breaking change](./backwards-compatibility#semantic-changes). From 6c5305d19d6ba7705adfb50e9d9bd90e1a362702 Mon Sep 17 00:00:00 2001 From: Alex Stephen Date: Fri, 14 Nov 2025 12:19:40 -0800 Subject: [PATCH 3/3] prettier --- aep/general/0157/aep.md.j2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/aep/general/0157/aep.md.j2 b/aep/general/0157/aep.md.j2 index 1576785d..9305cb11 100644 --- a/aep/general/0157/aep.md.j2 +++ b/aep/general/0157/aep.md.j2 @@ -21,7 +21,8 @@ named `read_mask`. - An API **may** allow read masks with non-terminal repeated fields (unlike update masks), but is not obligated to do so. -List serialization / deserialization must conform to [RFC 9651](https://www.rfc-editor.org/rfc/rfc9651.html#name-serializing-a-list) +List serialization / deserialization must conform to +[RFC 9651](https://www.rfc-editor.org/rfc/rfc9651.html#name-serializing-a-list) **Note:** Changing the default value of `read_mask` is a [breaking change](./backwards-compatibility#semantic-changes).