Add Material icons to all pages, rewrite examples page as step-by-step guide

docs/examples.md

@@ -1,38 +1,92 @@
-# REAL EXAMPLE
+# :material-script-text: An example of a proper succession plan with Bitcoin
 
-!!! danger "Draft — needs review before publishing"
-    This page has not been checked against the plugin's actual behaviour. It
-    was written from the manual's own descriptions elsewhere, which may not
-    be complete or precise enough on their own — treat every claim below,
-    especially about costs and timing, as unverified until confirmed with
-    the developers or by testing directly. Do not treat it as authoritative
-    yet.
+A concrete, start-to-finish walkthrough of how someone actually sets up a Bitcoin
+inheritance with BAL — and keeps it current for years without spending anything.
 
-Real-world scenarios, to make the mechanics concrete.
+## Step by step
 
-## Inheritance across three continents, renewed for years at no cost
+<div class="steps" markdown>
 
-**The setup.** Four heirs, living in three different countries. A delivery time of **5 years**, and several Will-Executors selected from the [WeList](will-executors/welist.md) for redundancy.
+<div class="step" markdown>
+**:material-shield-check: Start from Electrum.** You use [Electrum](https://electrum.org),
+a state-of-the-art Bitcoin wallet with one of the longest security track records in the
+ecosystem. BAL builds on it rather than reinventing the wallet.
+</div>
 
-**Cost at setup: zero.** Both fees — the miner fee and the Will-Executor fee — are only paid **once**, at the moment a Will-Executor actually broadcasts the inheritance. Setting up the will, signing it, and sending it to several servers costs nothing beyond the wallet's own normal use.
+<div class="step" markdown>
+**:material-usb-flash-drive: Add a hardware wallet (optional).** If you want, pair Electrum
+with a hardware device to raise the security of your keys even further. BAL works the same
+either way — Electrum still does all the signing.
+</div>
 
-**Staying current costs nothing, as long as you don't push the date later.** Ordinary use of the wallet — receiving funds, spending some, adding or editing an heir — makes the plugin rebuild the will automatically. Because this **anticipates** the delivery date by one day and redistributes it to the same Will-Executors, it is a free operation: no on-chain fee, no signature beyond the one Electrum already asks for. See [Postponing vs anticipating](user-guide/updating.md#postponing-vs-anticipating).
+<div class="step" markdown>
+**:material-account-heart: You have funds to protect.** You hold bitcoin in Electrum that,
+in case of an accident, death, or a lost seed, should reach your children — or simply a
+backup wallet of your own.
+</div>
 
-!!! warning "One thing this does *not* do for free"
-    Bringing forward the inheritance simply brings the date forward by one day and resends it to the Will-Executors, at no cost.
-    If, on the other hand, you wish to maintain a fixed time horizon — "always 5 years from today", as explained in the [Delivery time](user-guide/delivery-time.md) section — in this case the date is postponed each time it is updated.
-    This involves postponing the date further into the future, which requires a full on-chain transaction to first invalidate the previously distributed will. This incurs a mining fee on the Bitcoin blockchain.
+<div class="step" markdown>
+**:material-puzzle: Install the BAL plugin.** Add Bitcoin After Life to Electrum. See
+[Installation](getting-started/installation.md).
+</div>
 
-**What this looks like over time:**
+<div class="step" markdown>
+**:material-auto-fix: Set up the inheritance with the guided wizard.** BAL walks you through
+the whole thing step by step — see [Create your first will](getting-started/quick-start.md).
+</div>
 
-- **Year 0.** The will is created: 5 years out, 4 heirs, several Will-Executors. Cost: 0.
-- **Year 1–2.** The wallet is used normally — a few incoming and outgoing transactions. Each one triggers a free refresh. The delivery date itself hasn't moved, so the horizon has quietly shrunk to 3–4 years. Cost: 0.
-- **Year 3.** Time to push the horizon back out to 5 years. This is a postponement: one small on-chain transaction to invalidate the old will before signing the new one. Cost: one miner fee, paid by the wallet owner.
-- **Onward.** Repeat every 2–3 years — see [How often to renew](user-guide/updating.md#how-often-to-renew). Each cycle also picks up newer Will-Executors that joined the network since the last renewal.
+<div class="step" markdown>
+**:material-account-group: Add your heirs and their shares.** Enter how many heirs receive
+the funds and the share for each. *To avoid future disputes, equal shares for everyone are
+usually the wisest choice.*
+</div>
 
-The heirs are not involved in any way throughout this entire process. They simply need to keep their receiving wallet safe, or the sheets on which the seed is written (Bitcoin private keys, 12 or 24 words), which we will have taken care to give them if they do not already have a Bitcoin wallet or are not old enough to manage one.
-They do not need to know the date of the will, nor do they need to take any action: the entire mechanism operates invisibly until the day it is needed.
-Furthermore, they do not know how much in Bitcoin funds awaits them, unless we choose to tell them.
+<div class="step" markdown>
+**:material-calendar-clock: Choose the delivery date.** For example 5 or 10 years from now.
+</div>
+
+<div class="step" markdown>
+**:material-file-sign: The plugin builds the post-dated transaction.** It includes the fee
+for the miners and for the Will-Executors — the servers that hold the will until the chosen
+date and, on that day, broadcast it to the Bitcoin nodes that will accept the transaction.
+
+!!! success "Setting up and updating a will costs nothing"
+    You pay no fee to create or update an inheritance. The fees exist only in the transaction
+    itself and are paid **only if and when** the inheritance is actually executed.
+</div>
+
+<div class="step" markdown>
+**:material-refresh: Renew it once a year or two.** Mark it in your calendar. When you renew
+— adding an heir, changing shares — the plugin rewrites the inheritance transaction and
+re-sends it to the Will-Executors **dated one day earlier**, so you avoid an on-chain
+transaction and any mining fee. Renewing regularly brings two real advantages:
+
+- **More redundancy** — each renewal can pick up additional Will-Executors that will hold
+your will until the delivery date.
+- **Future-proofing** — a fresh time-locked transaction can incorporate future Bitcoin
+protocol upgrades, such as quantum-resistant security, as they arrive.
+</div>
+
+</div>
+
+## Using your wallet normally
+
+Setting up an inheritance does not freeze your wallet — you keep using Electrum as usual.
+
+If you **receive** or **spend** funds after the will is set up, the next time you close
+Electrum the BAL plugin checks your balance (by inspecting your UTXOs) and warns you if the
+inheritance needs updating.
+
+Here too the plugin **anticipates the date by one day**. So a will set to execute on
+**30 July 2031** is reissued for **29 July 2031** — with no need to write anything on-chain
+and no miner fee. This works because an *earlier* time-locked transaction automatically
+invalidates the later one it replaces.
+
+!!! info "Why anticipating is free, and postponing is not"
+    Moving the date **earlier** (anticipating) is free, because the new transaction simply
+    supersedes the old one. Moving the date **later** (postponing) is the one case that needs
+    a real on-chain transaction, and therefore a small miner fee. For the full mechanics see
+    [Keeping the will up to date](user-guide/updating.md#postponing-vs-anticipating).
 
 ---