Code samples: READMEs and smarter parsing

content/_code-samples/escrow/README.md

@@ -1,3 +1,5 @@
-# Escrow
+# Escrows
 
 Create, finish, and cancel [Escrows](https://xrpl.org/escrow.html) using conditional or time-based release.
+
+Examples from the [Escrow Tutorials](https://xrpl.org/use-escrows.html).

content/_code-samples/freeze/README.md

@@ -0,0 +1,5 @@
+# Freezes
+
+Freeze and unfreeze issued tokens, check freeze status, or give up the ability to freeze tokens.
+
+Examples from the [Freeze tutorials](https://xrpl.org/use-tokens.html).

content/_code-samples/get-started/README.md

@@ -0,0 +1,9 @@
+# Get Started
+
+Introductory code samples showing how to connect to the XRP Ledger and query it for data.
+
+For more context, see the Get Started tutorial for your preferred language:
+
+- [Python](https://xrpl.org/get-started-using-python.html)
+- [Java](https://xrpl.org/get-started-using-java.html)
+- [JavaScript](https://xrpl.org/get-started-using-javascript.html)

content/_code-samples/issue-a-token/README.md

@@ -0,0 +1,5 @@
+# Issue a Fungible Token
+
+Configure issuer settings and issue fungible tokens to a hot wallet.
+
+For an interactive tutorial demonstrating the function of these code samples, see [Issue a Fungible Token](https://xrpl.org/issue-a-fungible-token.html).

content/_code-samples/key-derivation/README.md

@@ -0,0 +1,5 @@
+# Cryptographic Key Derivation
+
+Derive secp256k1 or Ed25519 key pairs from seeds in any of the XRP Ledger's encodings and formats.
+
+For background and diagrams, see [Key Derivation](https://xrpl.org/cryptographic-keys.html#key-derivation).

content/_code-samples/monitor-payments-websocket/README.md

@@ -0,0 +1,3 @@
+# Monitor Incoming Payments with WebSocket
+
+Use the WebSocket protocol to watch for incoming payments to an XRP Ledger address, _without_ using a client library.

content/_code-samples/require-destination-tags/README.md

@@ -0,0 +1,5 @@
+# Require Destination Tags
+
+Require incoming payments to your account to specify a [Destination Tag](https://xrpl.org/source-and-destination-tags.html) so you know whom to credit.
+
+Examples from the [Require Destination Tags tutorial](https://xrpl.org/require-destination-tags.html).

content/_code-samples/secure-signing/README.md

@@ -0,0 +1,5 @@
+# Secure Signing
+
+Sign transactions from the security of your own machine.
+
+For more information and more options, see [Set Up Secure Signing](https://xrpl.org/set-up-secure-signing.html).

content/_code-samples/send-xrp/README.md

@@ -0,0 +1,5 @@
+# Send XRP
+
+Send a direct XRP payment to another account in the XRP Ledger.
+
+Examples from the interactive [Send XRP tutorial](https://xrpl.org/send-xrp.html).

content/_code-samples/submit-and-verify/README.md

@@ -1,8 +1,11 @@
 # Submit and Verify
 
-Example JavaScript code using ripple-lib to submit a signed transaction blob and wait until it has a final result.
+Example code to submit a signed transaction blob and wait until it has a final result.
 
-Example usage:
+- [submit-and-verify.js](js/submit-and-verify.js): ripple-lib 1.x version.
+- [submit-and-verify2.js](js/submit-and-verify2.js): xrpl.js 2.x version. Unlike the submitAndWait() method built into xrpl.js, this checks the server's available history and returns a different code when the transaction's status is unknowable with the server's available history versus if the transaction was _definitely_ not confirmed by consensus.
+
+Example usage (ripple-lib 1.x):
 
 ```js
 // example testnet creds. Don't use for real

content/_code-samples/tx-serialization/README.md

@@ -0,0 +1,5 @@
+# Transaction Serialization
+
+Convert transactions and other XRPL data from JSON to their canonical binary format for signing or cryptographic verification.
+
+For a detailed explanation, see [Serialization](https://xrpl.org/serialization.html).

content/_code-samples/use-tickets/README.md

@@ -0,0 +1,5 @@
+# Tickets
+
+Create a Ticket and use it to send a transaction out of the usual Sequence order.
+
+For more context, see the interactive [Use Tickets tutorial](https://xrpl.org/use-tickets.html).