Skip to content

Commit 126508e

Browse files
authored
fix(AIP-140): explicitly call out units using abbreviations (#1572)
1 parent 9524a9e commit 126508e

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

aip/general/0140.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,12 @@ Examples:
9393
- `spec` (**not** `specification`)
9494
- `stats` (**not** `statistics`)
9595

96+
Furthermore, well known abbreviations for units **should** be used in field names.
97+
See [AIP-141][] for more guidance on fields that represent quantities. Examples:
98+
99+
- `distance_km` (**not** `distance_kilometers`)
100+
- `width_px` (**not** `width_pixels`)
101+
96102
### Adjectives
97103

98104
For uniformity, field names that contain both a noun and an adjective
@@ -201,6 +207,7 @@ creating a more coherent surface. At the same time, the requirement being a
201207

202208
## Changelog
203209

210+
- **2025-10-23**: Call out AIP-141 unit abbreviations as preferred.
204211
- **2025-03-10**: Add rationale for URI guidance.
205212
- **2024-12-20**: Copy over abbreviations guidance from old design site.
206213
- **2024-08-26**: Codify exception to string and base64 guidance

0 commit comments

Comments
 (0)