From 1798556d30248a361055868b8fdd7ac5577ce447 Mon Sep 17 00:00:00 2001 From: Noah Dietz Date: Thu, 23 Oct 2025 10:40:51 -0700 Subject: [PATCH 1/3] fix(AIP-140): explicitly call out units using abbreviations --- aip/general/0140.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/aip/general/0140.md b/aip/general/0140.md index 0354f03882..674891b4a8 100644 --- a/aip/general/0140.md +++ b/aip/general/0140.md @@ -93,6 +93,12 @@ Examples: - `spec` (**not** `specification`) - `stats` (**not** `statistics`) +Furthermore, well known abbreviations for units **should** be used in field names. + See [AIP-141][] for more guidance on fields that represent quantities. Examples: + +- `distance_km` (**not** `distance_kilometers`) +- `width_px` (**not** `width_pixels`) + ### Adjectives For uniformity, field names that contain both a noun and an adjective From 55ffc274df0e2826c91c7888fd227d32528d26cb Mon Sep 17 00:00:00 2001 From: Noah Dietz Date: Thu, 23 Oct 2025 10:43:07 -0700 Subject: [PATCH 2/3] chore(AIP-140): add changelog entry --- aip/general/0140.md | 1 + 1 file changed, 1 insertion(+) diff --git a/aip/general/0140.md b/aip/general/0140.md index 674891b4a8..d3ed36f32a 100644 --- a/aip/general/0140.md +++ b/aip/general/0140.md @@ -207,6 +207,7 @@ creating a more coherent surface. At the same time, the requirement being a ## Changelog +- **2025-10-23**: Call out AIP-141 unit abbreviations as preferred. - **2025-03-10**: Add rationale for URI guidance. - **2024-12-20**: Copy over abbreviations guidance from old design site. - **2024-08-26**: Codify exception to string and base64 guidance From 8104bc30428f12832a06685cfebb20a856dbf557 Mon Sep 17 00:00:00 2001 From: Noah Dietz Date: Thu, 23 Oct 2025 10:43:46 -0700 Subject: [PATCH 3/3] chore(AIP-140): remove extraneous leading whitespace --- aip/general/0140.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aip/general/0140.md b/aip/general/0140.md index d3ed36f32a..82a95616d1 100644 --- a/aip/general/0140.md +++ b/aip/general/0140.md @@ -94,7 +94,7 @@ Examples: - `stats` (**not** `statistics`) Furthermore, well known abbreviations for units **should** be used in field names. - See [AIP-141][] for more guidance on fields that represent quantities. Examples: +See [AIP-141][] for more guidance on fields that represent quantities. Examples: - `distance_km` (**not** `distance_kilometers`) - `width_px` (**not** `width_pixels`)