File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff 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.
You can’t perform that action at this time.
0 commit comments