Skip to content

Commit 9847474

Browse files
authored
fix(AIP-140): add uri guidance rationale (#1490)
1 parent 4e84ff8 commit 9847474

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

aip/general/0140.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,8 +173,19 @@ field **should not** have a uniqueness requirement.
173173
- For naming fields representing quantities, see [AIP-141][].
174174
- For naming fields representing time, see [AIP-142][].
175175

176+
## Rationale
177+
178+
### URI vs URL
179+
180+
The guidance itself mentions that all URLs are URIs, but not all URIs are URLs.
181+
The goal of aligning on URI is to enable a more generalizable field, that can
182+
handle a variety of use cases, as well as drive standardization across APIs,
183+
creating a more coherent surface. At the same time, the requirement being a
184+
**should** allows for more specific terms when it truly merits it.
185+
176186
## Changelog
177187

188+
- **2025-03-10**: Add rationale for URI guidance.
178189
- **2024-12-20**: Copy over abbreviations guidance from old design site.
179190
- **2024-08-26**: Codify exception to string and base64 guidance
180191
- **2024-05-18**: Documented the effect of field names on client surfaces.

0 commit comments

Comments
 (0)