BitcoinDesign · GBKS · Mar 19, 2024 · Mar 19, 2024 · Mar 19, 2024 · Mar 20, 2024
diff --git a/_sass/minima/_article.scss b/_sass/minima/_article.scss
@@ -224,6 +224,16 @@ article.guide {
     }
   }
 
+  span {
+    &.-blue {
+        color: $blue;
+    }
+
+    &.-green {
+        color: $green;
+    }
+  }
+
   > iframe {
     display: block;
   }

diff --git a/assets/images/guide/how-it-works/human-readable-addresses/clipboard-mobile.png b/assets/images/guide/how-it-works/human-readable-addresses/clipboard-mobile.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/clipboard.png b/assets/images/guide/how-it-works/human-readable-addresses/clipboard.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/contact-card-mobile.jpg b/assets/images/guide/how-it-works/human-readable-addresses/contact-card-mobile.jpg
diff --git a/...s/images/guide/how-it-works/human-readable-addresses/[email protected] b/...s/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/contact-card.jpg b/assets/images/guide/how-it-works/human-readable-addresses/contact-card.jpg
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/...rks/human-readable-addresses/dns-payment-instructions-intermediaries-mobile.png b/...rks/human-readable-addresses/dns-payment-instructions-intermediaries-mobile.png
diff --git a/.../human-readable-addresses/[email protected] b/.../human-readable-addresses/[email protected]
diff --git a/...w-it-works/human-readable-addresses/dns-payment-instructions-intermediaries.png b/...w-it-works/human-readable-addresses/dns-payment-instructions-intermediaries.png
diff --git a/...t-works/human-readable-addresses/[email protected] b/...t-works/human-readable-addresses/[email protected]
diff --git a/...w-it-works/human-readable-addresses/dns-payment-instructions-mapping-mobile.png b/...w-it-works/human-readable-addresses/dns-payment-instructions-mapping-mobile.png
diff --git a/...t-works/human-readable-addresses/[email protected] b/...t-works/human-readable-addresses/[email protected]
diff --git a/...uide/how-it-works/human-readable-addresses/dns-payment-instructions-mapping.png b/...uide/how-it-works/human-readable-addresses/dns-payment-instructions-mapping.png
diff --git a/...e/how-it-works/human-readable-addresses/[email protected] b/...e/how-it-works/human-readable-addresses/[email protected]
diff --git a/...how-it-works/human-readable-addresses/dns-payment-instructions-trust-mobile.png b/...how-it-works/human-readable-addresses/dns-payment-instructions-trust-mobile.png
diff --git a/...-it-works/human-readable-addresses/[email protected] b/...-it-works/human-readable-addresses/[email protected]
diff --git a/.../guide/how-it-works/human-readable-addresses/dns-payment-instructions-trust.png b/.../guide/how-it-works/human-readable-addresses/dns-payment-instructions-trust.png
diff --git a/...ide/how-it-works/human-readable-addresses/[email protected] b/...ide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/education-mobile.jpg b/assets/images/guide/how-it-works/human-readable-addresses/education-mobile.jpg
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/education.jpg b/assets/images/guide/how-it-works/human-readable-addresses/education.jpg
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/...guide/how-it-works/human-readable-addresses/human-readable-addresses-mobile.jpg b/...guide/how-it-works/human-readable-addresses/human-readable-addresses-mobile.jpg
diff --git a/...de/how-it-works/human-readable-addresses/[email protected] b/...de/how-it-works/human-readable-addresses/[email protected]
diff --git a/...uide/how-it-works/human-readable-addresses/human-readable-addresses-preview.jpg b/...uide/how-it-works/human-readable-addresses/human-readable-addresses-preview.jpg
diff --git a/...images/guide/how-it-works/human-readable-addresses/human-readable-addresses.jpg b/...images/guide/how-it-works/human-readable-addresses/human-readable-addresses.jpg
diff --git a/...ges/guide/how-it-works/human-readable-addresses/[email protected] b/...ges/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/input-mobile.png b/assets/images/guide/how-it-works/human-readable-addresses/input-mobile.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/input.png b/assets/images/guide/how-it-works/human-readable-addresses/input.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/...w-it-works/human-readable-addresses/lightning-address-intermediaries-mobile.png b/...w-it-works/human-readable-addresses/lightning-address-intermediaries-mobile.png
diff --git a/...t-works/human-readable-addresses/[email protected] b/...t-works/human-readable-addresses/[email protected]
diff --git a/...uide/how-it-works/human-readable-addresses/lightning-address-intermediaries.png b/...uide/how-it-works/human-readable-addresses/lightning-address-intermediaries.png
diff --git a/...e/how-it-works/human-readable-addresses/[email protected] b/...e/how-it-works/human-readable-addresses/[email protected]
diff --git a/...uide/how-it-works/human-readable-addresses/lightning-address-mapping-mobile.png b/...uide/how-it-works/human-readable-addresses/lightning-address-mapping-mobile.png
diff --git a/...e/how-it-works/human-readable-addresses/[email protected] b/...e/how-it-works/human-readable-addresses/[email protected]
diff --git a/...mages/guide/how-it-works/human-readable-addresses/lightning-address-mapping.png b/...mages/guide/how-it-works/human-readable-addresses/lightning-address-mapping.png
diff --git a/...es/guide/how-it-works/human-readable-addresses/[email protected] b/...es/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/mapping-mobile.png b/assets/images/guide/how-it-works/human-readable-addresses/mapping-mobile.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/mapping.png b/assets/images/guide/how-it-works/human-readable-addresses/mapping.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/setup-big.png b/assets/images/guide/how-it-works/human-readable-addresses/setup-big.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/setup-mobile.png b/assets/images/guide/how-it-works/human-readable-addresses/setup-mobile.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/setup.png b/assets/images/guide/how-it-works/human-readable-addresses/setup.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/update-mobile.png b/assets/images/guide/how-it-works/human-readable-addresses/update-mobile.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/update.png b/assets/images/guide/how-it-works/human-readable-addresses/update.png
diff --git a/assets/images/guide/how-it-works/human-readable-addresses/[email protected] b/assets/images/guide/how-it-works/human-readable-addresses/[email protected]
diff --git a/guide/how-it-works/human-readable-addresses.md b/guide/how-it-works/human-readable-addresses.md
diff --git a/guide/how-it-works/introduction.md b/guide/how-it-works/introduction.md
@@ -58,7 +58,7 @@ Learn about how nodes help keep bitcoin decentralized and enforce its rules.
 
 ### [Payment request formats]({{ '/guide/how-it-works/payment-request-formats/' | relative_url }})
 
-Learn about the different types of payment request formats, from a standard on-chain address to a lightning address, that exist in bitcoin.
+Learn about the different formats for payment information that exist in bitcoin, from standard on-chain to lightning, and [human readable addresses]({{ '/guide/how-it-works/human-readable-addresses/' | relative_url }}).
 
 ---
 

diff --git a/guide/how-it-works/payment-request-formats.md b/guide/how-it-works/payment-request-formats.md
@@ -4,6 +4,7 @@ title: Payment request formats
 description: An introduction to the different bitcoin payment request formats.
 nav_order: 6
 parent: How it works
+has_children: true
 permalink: /guide/how-it-works/payment-request-formats/
 redirect_from:
  - /guide/payments/send/payment-request-formats/
@@ -138,7 +139,7 @@ LNURL-Pay allows senders to dynamically request an invoice from the receiver to
 
 ##### Lightning address
 
-[Lightning addresses](https://lightningaddress.com) build on top of LNURL-Pay and give users a more human-readable payment address. They use the very familiar email format ([email protected]) to request payments.
+[Lightning addresses](https://lightningaddress.com) build on top of LNURL-Pay and give users a more [human readable payment address]({{ '/guide/how-it-works/human-readable-addresses/' | relative_url }}). They use the very familiar email format ([email protected]_) to request payments.
 
 ##### Withdraw
 
@@ -235,7 +236,7 @@ Payment codes have been popularised in wallets such as [Samourai](https://samour
 
 A downside to payment codes is that they require an additional on-chain transaction each time two users want to connect and use them. [Silent payments](https://gist.github.com/RubenSomsen/c43b79517e7cb701ebf77eec6dbb46b8?permalink_comment_id=4113680) are a new experimental proposal that prevents the need for this additional on-chain transaction at the cost of extra bandwidth for receivers.
 
-Some wallets use what is called a [PayNym](https://paynym.is/) to abstract payment codes into more human readable payment request formats. However, this is not standardized, directories are not open-source, and currently Samourai is the only operator running a directory.
+Static payment codes are great for use with [DNS-based human readable addresses]({{ '/guide/how-it-works/human-readable-addresses/#dns-payment-instructions' | relative_url }}).
 
 </div>
 
@@ -262,11 +263,11 @@ You can learn more about unified payment requests [here](https://bitcoinqr.dev/)
 
 ---
 
-Next, we will learn about the different [private key schemes]({{ '/guide/how-it-works/private-key-management/introduction/' | relative_url }}) used to secure your bitcoin.
+As you noticed, these formats are impossible to memorize and pronounce. That is what [human readable addresses]({{ '/guide/how-it-works/human-readable-addresses/' | relative_url }}) aim to solve.
 
 {% include next-previous.html
    previousUrl = "/guide/how-it-works/nodes/"
    previousName = "Nodes"
-   nextUrl = "/guide/how-it-works/private-key-management/introduction/"
-   nextName = "Private key management"
+   nextUrl = "/guide/how-it-works/human-readable-addresses/"
+   nextName = "Human readable addresses"
 %}