diff --git a/pages/guidelines.mdx b/pages/guidelines.mdx index e9d7a596f9..d73dc3e6cd 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 in contexts where technical precision and binary vs decimal distinction is critical, particularly for memory. +
## Wording and vocabulary