diff --git a/_autocrossref.yaml b/_autocrossref.yaml index cf9a27fa..73b439cf 100644 --- a/_autocrossref.yaml +++ b/_autocrossref.yaml @@ -13,8 +13,6 @@ '`alert` message': alert message '`alert` messages': alert message '`amount`': pp amount -## bitcoin -- Recommend against bitcoin (singular) because of confusion between protocol, software, denomination -bitcoins: bitcoin QR code: URI QR code bitcoin QR codes: URI QR code '`bitcoin:` URI': bitcoin uri @@ -23,8 +21,6 @@ bitcoinj: '`block` message': block message '`block` messages': block message certificate chain: -denomination: -denominations: denomination DER: DER format: der DER-formatted: der @@ -77,8 +73,6 @@ merge: Merge avoidance: micropayment channel: micropayment channels: micropayment channel -millibitcoin: millibitcoins -millibitcoins: '`MSG_BLOCK`': msg_block '`MSG_FILTERED_BLOCK`': msg_filtered_block '`MSG_TX`': msg_tx @@ -134,8 +128,6 @@ refunds: refund root certificate: RPC: RPCs: rpc -satoshi: -satoshis: satoshi '`script`': pp script secp256k1: standard block relay: diff --git a/_data/glossary/en/denominations.yaml b/_data/glossary/en/denominations.yaml new file mode 100644 index 00000000..08f8714b --- /dev/null +++ b/_data/glossary/en/denominations.yaml @@ -0,0 +1,40 @@ +--- +# This file is licensed under the MIT License (MIT) available on +# http://opensource.org/licenses/MIT. + +required: + #-------------40 characters-------------# + title_max_40_characters_no_formatting: Denominations + + summary_max_255_characters_no_formatting: > + Denominations of Bitcoin value, usually measured in fractions of + a bitcoin but sometimes measured in multiples of a satoshi. One + bitcoin equals 100,000,000 satoshis. + + synonyms_shown_in_glossary_capitalize_first_letter: + - Denomination + - Bitcoins + - Satoshis + +optional: + synonyms_and_pluralizations_not_shown_in_glossary: + - denominations + - millibitcoin + - millibitcoins + - millibit + - millibits + - microbitcoin + - microbitcoins + - microbit + - microbits + - satoshi + ## Don't add bitcoin singular, we use bare "Bitcoin" massively often + ## Don't add bits; the dev docs use [binary] "bits" often + + not_to_be_confused_with_capitalize_first_letter: + - Binary bits, a unit of data with two possible values + + links_html_or_markdown_style_capitalize_first_letter: + - "[Bitcoin Units](https://en.bitcoin.it/wiki/Units) --- Bitcoin Wiki" + +--- diff --git a/_includes/guide_payment_processing.md b/_includes/guide_payment_processing.md index b3796b2f..81e7a187 100644 --- a/_includes/guide_payment_processing.md +++ b/_includes/guide_payment_processing.md @@ -155,9 +155,9 @@ You must pay by: 2014-04-01 at 23:00 UTC {% autocrossref %} -Indicating the [denomination][]{:#term-denomination}{:.term} is critical. As of this writing, popular -Bitcoin wallet software defaults to denominating amounts in either [bitcoins][]{:#term-bitcoins}{:.term} (BTC) -, [millibitcoins][]{:#term-millibitcoins}{:.term} (mBTC) or microbitcoins (uBTC, "[bits][]{:#term-bits}{:.term}"). Choosing between each unit is widely supported, +Indicating the denomination is critical. As of this writing, popular +Bitcoin wallet software defaults to denominating amounts in either bitcoins (BTC) +, millibitcoins (mBTC) or microbitcoins (uBTC, "bits"). Choosing between each unit is widely supported, but other software also lets its users select denomination amounts from some or all of the following options: @@ -167,7 +167,7 @@ some or all of the following options: | 0.01 | bitcent (cBTC) | | 0.001 | millibitcoin (mBTC) | | 0.000001 | microbitcoin (uBTC, "bits") | -| 0.00000001 | [satoshi][]{:#term-satoshi}{:.term} | +| 0.00000001 | satoshi | {% endautocrossref %} diff --git a/_includes/references.md b/_includes/references.md index 9fbf73c3..ed8c8093 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -5,12 +5,9 @@ http://opensource.org/licenses/MIT. [bitcoin URI]: /en/developer-guide#term-bitcoin-uri "A URI which allows receivers to encode payment details so spenders don't have to manually enter addresses and other details" -[bitcoins]: /en/developer-guide#term-bitcoins "A primary accounting unit used in Bitcoin; 100 million satoshis" -[bits]: /en/developer-guide#term-bits "0.000001 bitcoins (100 satoshis)" [certificate chain]: /en/developer-examples#term-certificate-chain "A chain of certificates connecting a individual's leaf certificate to the certificate authority's root certificate" [coinbase block height]: /en/developer-reference#term-coinbase-block-height "The current block's height encoded into the first bytes of the coinbase field" [data-pushing op code]: https://en.bitcoin.it/wiki/Script#Constants "Any op code from 0x01 to 0x4e which pushes data on to the script evaluation stack" -[denomination]: /en/developer-guide#term-denomination "bitcoins (BTC), bitcents (cBTC), millibitcoins (mBTC), bits (uBTC, microbitcoins), or satoshis" [fiat]: /en/developer-guide#term-fiat "National currencies such as the dollar or euro" [intermediate certificate]: /en/developer-examples#term-intermediate-certificate "A intermediate certificate authority certificate which helps connect a leaf (receiver) certificate to a root certificate authority" [key index]: /en/developer-guide#term-key-index "An index number used in the HD wallet formula to generate child keys from a parent key" @@ -20,7 +17,6 @@ http://opensource.org/licenses/MIT. [merge]: /en/developer-guide#term-merge "Spending, in the same transaction, multiple outputs which can be traced back to different previous spenders, leaking information about how many satoshis you control" [merge avoidance]: /en/developer-guide#term-merge-avoidance "A strategy for selecting which outputs to spend that avoids merging outputs with different histories that could leak private information" [message]: /en/developer-guide#term-message "A parameter of bitcoin: URIs which allows the receiver to optionally specify a message to the spender" -[millibitcoins]: /en/developer-guide#term-millibitcoins "0.001 bitcoins (100,000 satoshis)" [msg_tx]: /en/developer-reference#term-msg_tx "The TXID data type identifier of an inventory on the P2P network" [msg_block]: /en/developer-reference#term-msg_block "The block header hash data type identifier of an inventory on the P2P network" [msg_filtered_block]: /en/developer-reference#term-msg_block "An alternative to the block header hash data type identifier of an inventory on the P2P network used to request a merkle block" @@ -55,8 +51,6 @@ http://opensource.org/licenses/MIT. [recurrent rebilling]: /en/developer-guide#rebilling-recurring-payments "Billing a spender on a regular schedule" [refund]: /en/developer-guide#issuing-refunds "A transaction which refunds some or all satoshis received in a previous transaction" [root certificate]: /en/developer-examples#term-root-certificate "A certificate belonging to a certificate authority (CA)" -[satoshi]: /en/developer-guide#term-satoshi "The smallest unit of Bitcoin value; 0.00000001 bitcoins. Also used generically for any value of bitcoins" -[satoshis]: /en/developer-guide#term-satoshi "The smallest unit of Bitcoin value; 0.00000001 bitcoins. Also used generically for any value of bitcoins" [ssl signature]: /en/developer-examples#term-ssl-signature "Signatures created and recognized by major SSL implementations such as OpenSSL" [standard block relay]: /en/developer-guide#term-standard-block-relay "The regular block relay method: announcing a block with an inv message and waiting for a response" [transaction]: /en/developer-guide#transactions "A transaction spending satoshis"