Skip to content

Commit 250a86e

Browse files
authored
fix(guidelines): update bits and bytes guidance (#5572)
* fix(guidelines): update bits and bytes guidance * Update pages/guidelines.mdx
1 parent cf29166 commit 250a86e

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

pages/guidelines.mdx

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -378,17 +378,23 @@ Use the [Oxford comma](https://en.wikipedia.org/wiki/Serial_comma) (also known a
378378

379379
### Bits and bytes
380380

381-
- Add a space between the bits/bytes abbreviation and the number, e.g. `100 MB`, `1 Gbps`
381+
- Add a space between the bits/bytes abbreviation and the number, e.g. `100 MB`, `1 Gbps`.
382382
- Use the following abbreviations:
383383

384-
| Term | Abbreviation | Example |
385-
| --------------------- | ------------------|----------------------------------------- |
386-
| megabyte | MB | Memory: 100 MB |
387-
| gigabyte | MB | Memory: 1 GB |
388-
| gigabit | none | Connectivity; up to 10 gigabit |
389-
| gigabits per second | Gbps | Bandwidth: 1 Gbps |
390-
| megabits per second | Mbps | Bandwidth: 100 Mbps |
391-
| gigabit-seconds | GB-s | Storage: 1 GB-s |
384+
| Abbreviation | Unit | Used for | Example |
385+
|------------------|--------------------------------|--------------------------------------------|--------------------------------------|
386+
| MB, GB, TB | Megabyte / Gigabyte / Terabyte | Storage capacity, RAM, VRAM, disk size | Storage: 32 GB |
387+
| MiB, GiB, TiB | Mebibyte / Gibibyte / Tebibyte | RAM / memory in binary multiples where technical precision is important | RAM: 512 MiB |
388+
| Mbps, Gbps | Megabit per second / Gigabit per second | Network bandwidth (bits per second) | Bandwidth: up to 10 Gbps |
389+
| MB-s, GB-s | Megabyte seconds / Gigabyte seconds | Cumulative data transfer/consumption over time | Memory consumption: €0.10 per 100 000 GB-s |
390+
391+
<Message type="note">
392+
GB vs GiB is an SI vs binary distinction:
393+
- GB = 10⁹ bytes = 1,000,000,000 bytes
394+
- GiB = 2³⁰ bytes = 1,073,741,824 bytes
395+
<br/><br/>
396+
Use GiB/MiB in contexts where technical precision and binary vs decimal distinction is critical, particularly for memory.
397+
</Message>
392398

393399
## Wording and vocabulary
394400

0 commit comments

Comments
 (0)