diff --git a/_compress_images_cache.yml b/_compress_images_cache.yml index 6278dcbf1..f86a0f6f7 100644 --- a/_compress_images_cache.yml +++ b/_compress_images_cache.yml @@ -2022,6 +2022,10 @@ assets/images/guide/daily-spending-wallet/contacts/receive-qr-with-contact-big.p assets/images/guide/daily-spending-wallet/contacts/sending-home-big.png: sending-home-big.png assets/images/guide/daily-spending-wallet/contacts/sending-pick-contact-big.png: sending-pick-contact-big.png assets/images/guide/daily-spending-wallet/contacts/sending-review-big.png: sending-review-big.png +assets/images/guide/designing-products/units-and-symbols/formatting-pluralization.png: formatting-pluralization.png +assets/images/guide/designing-products/units-and-symbols/formatting-pluralization@2x.png: formatting-pluralization@2x.png +assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile.png: formatting-pluralization-mobile.png +assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile@2x.png: formatting-pluralization-mobile@2x.png assets/images/guide/daily-spending-wallet/backup-and-recovery/automatic-cloud-backup/cloud-backup-PIN-full.png: cloud-backup-PIN-full.png assets/images/guide/daily-spending-wallet/backup-and-recovery/automatic-cloud-backup/cloud-backup-PIN-verify-full.png: cloud-backup-PIN-verify-full.png assets/images/guide/daily-spending-wallet/backup-and-recovery/automatic-cloud-backup/cloud-backup-confirmation-full.png: cloud-backup-confirmation-full.png diff --git a/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile.png b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile.png new file mode 100644 index 000000000..4b0d323fd Binary files /dev/null and b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile.png differ diff --git a/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile@2x.png b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile@2x.png new file mode 100644 index 000000000..4fec83a62 Binary files /dev/null and b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile@2x.png differ diff --git a/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization.png b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization.png new file mode 100644 index 000000000..534aebb60 Binary files /dev/null and b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization.png differ diff --git a/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization@2x.png b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization@2x.png new file mode 100644 index 000000000..50ad521f4 Binary files /dev/null and b/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization@2x.png differ diff --git a/guide/designing-products/units-and-symbols.md b/guide/designing-products/units-and-symbols.md index 2e5a8419d..01427325a 100644 --- a/guide/designing-products/units-and-symbols.md +++ b/guide/designing-products/units-and-symbols.md @@ -226,6 +226,25 @@ Complex use cases often require users to interact with addresses, public keys, a Note that uppercase letter "O", uppercase letter "I", lowercase letter "l", and the number "0" are not valid characters in addresses, in order to prevent mistakes. As users may not be aware of this, using slashed zeros may still be a helpful design choice. +### Pluralization + +{% include picture.html + image = "/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization.png" + retina = "/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization@2x.png" + mobile = "/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile.png" + mobileRetina = "/assets/images/guide/designing-products/units-and-symbols/formatting-pluralization-mobile@2x.png" + alt-text = "Examples of different pluralization schemes for bitcoin and satoshis" + width = 800 + height = 278 + caption = "Examples of different pluralization schemes for bitcoin and satoshis" +%} + +Consider the best way to pluralize bitcoin units in your product. Treatment of plurals can differ between languages and cultures. When choosing a pluralization scheme, consider what your users are likely to be accustomed to. You can take the guess work out of this by using a pluralization ruleset, such as [`Intl.PluralRules`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules#examples). + +Typically, the word "bitcoin" can mean a singular or a plural. In the early days of bitcoin, it was common to see people use the word "bitcoins" as a plural. This has become a less commonly used word, though it's still grammatically correct. However, it's far more common to see the satoshi (sat) expressed as "satoshis" (sats) when plural. + +Whatever pluralization scheme you choose, it's good to be consistent with this choice throughout your product. + --- On to [interoperability]({{ '/guide/designing-products/interoperability/' | relative_url }}) which is essential for smooth interaction and migration between bitcoin products.