From cf168c819cceef5e9576c6e698e22577fa21b249 Mon Sep 17 00:00:00 2001 From: Yusuke Tsutsumi Date: Thu, 11 Dec 2025 21:37:38 -0800 Subject: [PATCH 1/3] fix(102): slash, not backslash, in API name The AEPs incorrectly used the term "backslash". fixes #395 --- aep/general/0102/aep.md.j2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aep/general/0102/aep.md.j2 b/aep/general/0102/aep.md.j2 index c78cb578..fb93bd80 100644 --- a/aep/general/0102/aep.md.j2 +++ b/aep/general/0102/aep.md.j2 @@ -27,7 +27,7 @@ The API Name: - **must** only uses valid domain name characters as specified in [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035#section-2.3.1), or a - backslash `[.-a-z0-9/]`) + slash `[.-a-z0-9/]`) - **must** use all lower case. - **should not** use path prefixes that could also be misconstrued as a resource collection (e.g. `apis.examples.com/users`) From ffcc4aad2b86ec984c29fc013a4cf4f5ba3f7152 Mon Sep 17 00:00:00 2001 From: Yusuke Tsutsumi Date: Fri, 12 Dec 2025 08:44:59 -0800 Subject: [PATCH 2/3] Update aep/general/0102/aep.md.j2 Co-authored-by: Mike Kistler --- aep/general/0102/aep.md.j2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aep/general/0102/aep.md.j2 b/aep/general/0102/aep.md.j2 index fb93bd80..4344adee 100644 --- a/aep/general/0102/aep.md.j2 +++ b/aep/general/0102/aep.md.j2 @@ -25,7 +25,7 @@ can still ensure uniqueness can be used. For example APIs served at The API Name: -- **must** only uses valid domain name characters as specified in +- **must** only use valid domain name characters as specified in [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035#section-2.3.1), or a slash `[.-a-z0-9/]`) - **must** use all lower case. From 33705d13d2a385ec41fa83f3d867f09fa9f51223 Mon Sep 17 00:00:00 2001 From: Yusuke Tsutsumi Date: Fri, 12 Dec 2025 08:47:11 -0800 Subject: [PATCH 3/3] address code review --- aep/general/0102/aep.md.j2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/aep/general/0102/aep.md.j2 b/aep/general/0102/aep.md.j2 index 4344adee..a79b706a 100644 --- a/aep/general/0102/aep.md.j2 +++ b/aep/general/0102/aep.md.j2 @@ -28,7 +28,8 @@ The API Name: - **must** only use valid domain name characters as specified in [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035#section-2.3.1), or a slash `[.-a-z0-9/]`) -- **must** use all lower case. +- **must** use all lowercase. +- **must** start with a lowercase letter. - **should not** use path prefixes that could also be misconstrued as a resource collection (e.g. `apis.examples.com/users`)