From 6d69d30b52f216b2bcd5c9b94085b555943a7e6c Mon Sep 17 00:00:00 2001 From: Rowena Date: Thu, 25 Sep 2025 18:15:09 +0200 Subject: [PATCH 1/2] fix(guidelines): update bits and bytes guidance --- pages/guidelines.mdx | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/pages/guidelines.mdx b/pages/guidelines.mdx index e9d7a596f9..453930e321 100644 --- a/pages/guidelines.mdx +++ b/pages/guidelines.mdx @@ -378,17 +378,23 @@ Use the [Oxford comma](https://en.wikipedia.org/wiki/Serial_comma) (also known a ### Bits and bytes -- Add a space between the bits/bytes abbreviation and the number, e.g. `100 MB`, `1 Gbps` +- Add a space between the bits/bytes abbreviation and the number, e.g. `100 MB`, `1 Gbps`. - Use the following abbreviations: -| Term | Abbreviation | Example | -| --------------------- | ------------------|----------------------------------------- | -| megabyte | MB | Memory: 100 MB | -| gigabyte | MB | Memory: 1 GB | -| gigabit | none | Connectivity; up to 10 gigabit | -| gigabits per second | Gbps | Bandwidth: 1 Gbps | -| megabits per second | Mbps | Bandwidth: 100 Mbps | -| gigabit-seconds | GB-s | Storage: 1 GB-s | +| Abbreviation | Unit | Used for | Example | +|------------------|--------------------------------|--------------------------------------------|--------------------------------------| +| MB, GB, TB | Megabyte / Gigabyte / Terabyte | Storage capacity, RAM, VRAM, disk size | Storage: 32 GB | +| MiB, GiB, TiB | Mebibyte / Gibibyte / Tebibyte | RAM / memory in binary multiples where technical precision is important | RAM: 512 MiB | +| Mbps, Gbps | Megabit per second / Gigabit per second | Network bandwidth (bits per second) | Bandwidth: up to 10 Gbps | +| MB-s, GB-s | Megabyte seconds / Gigabyte seconds | Cumulative data transfer/consumption over time | Memory consumption: €0.10 per 100 000 GB-s | + + +GB vs GiB is an SI vs binary distinction: +- GB = 10⁹ bytes = 1,000,000,000 bytes +- GiB = 2³⁰ bytes = 1,073,741,824 bytes +

+Use GiB/MiB for memory in contexts where technical precision and binary vs decimal distinction is critical. In other contexts, GB/MB may be appropriate for memory. + ## Wording and vocabulary From fe4b308dd5c33c7316afe08cbd6aa1d4bf5d8e26 Mon Sep 17 00:00:00 2001 From: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> Date: Fri, 26 Sep 2025 10:08:19 +0200 Subject: [PATCH 2/2] Update pages/guidelines.mdx --- pages/guidelines.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/guidelines.mdx b/pages/guidelines.mdx index 453930e321..d73dc3e6cd 100644 --- a/pages/guidelines.mdx +++ b/pages/guidelines.mdx @@ -393,7 +393,7 @@ GB vs GiB is an SI vs binary distinction: - GB = 10⁹ bytes = 1,000,000,000 bytes - GiB = 2³⁰ bytes = 1,073,741,824 bytes

-Use GiB/MiB for memory in contexts where technical precision and binary vs decimal distinction is critical. In other contexts, GB/MB may be appropriate for memory. +Use GiB/MiB in contexts where technical precision and binary vs decimal distinction is critical, particularly for memory. ## Wording and vocabulary