Clarity pass: glossary tooltips + first-time-reader reframe (Buckets 1 & 2) #1

Open
padreug wants to merge 4 commits from feedback-clarity-pass into main
Owner

Implements the reviewer feedback we sorted into Bucket 1 (objective clarity fixes) and Bucket 2 (structural reframes). Keeps the Bitcoin-native voice — the compromise for jargon is inline glossary tooltips, not dumbing anything down.

Glossary tooltips (the "don't dumb it down" compromise)

  • New GlossaryTerm.vue — dotted-underline term, reveals a one-line definition on hover or tap, with an optional "learn more ↗" link (Lightning → lightning.network, Nostr → nostr.com, Cypherpunk → wiki).
  • New GlossedText.vue + glossedParts() tokenizer — wraps glossary hits in any string. Boundary-aware, so "node" won't fire inside "Noderunners".
  • Wired into every slide subtitle (via SlideFrame) plus the entity-detail, ecosystem and tech card bodies. Terms defined: stack, node, Lightning, Nostr, Cypherpunk, mycelium, P&L.
  • Deliberately not portaled — the deck stage uses transforms + overflow, so a portaled popover would escape the themed .dark tree; the card floats inline instead.

Bucket 1 — objective fixes

  • "stack" / "node" / "Cypherpunk" / "P&L" / "Lightning" → glossed inline (define-everywhere, not just once).
  • "Pay by Lightning " → emoji + plain gloss ("tap to pay — instant settlement, tiny fees").
  • "venue buyouts" → "venue rental · private hire" everywhere (entity revenue + P&L line).
  • "Build it once" → "Build the stack once" and names the it: the shared hardware + software on decentralized protocols (Nostr + Bitcoin).
  • Self-hosting line surfaced on the Lab 484 slide (reviewer's clearest idea, previously buried on the building slide).
  • P&L "Tap to expand" affordance so the category breakdown is discoverable.

Bucket 2 — reframes

  • Title: "One soil, three flowers," not "3-in-1." Spells out the So·lL·unar wordmark (the reviewer misread the lL as "1L"), labels each flower with type + place (City · Austin, Farm · S. France, Pop-up · Travelling), and adds a "future flowers" slot. Entities slide echoes it and names the French environment.
  • Château du Faune → southern France, same property, made explicit (your note).
  • Ask → "Choose your way in" with numbered Option 1 / Option 2 — a decision, not a menu.
  • Roadmap: unpacked the "blueprint is the business" riddle into plain English.
  • Memberships: reframed as three recurring-revenue streams with revenue-at-target per tier (investor view, not a sales pitch).
  • Building: literal front/back layout ("club building in front, Cypherpunk Commons A & B in the back").

⚠️ One thing to resolve before sending

The memberships slide now shows Lunarpunk Locals ≈ $14,800/mo at its 100-member target, but the P&L conservatively models it at only $1,500/mo ("count TBD"). That contradiction predates this PR (it's flagged in data.ts), but the revenue framing makes it visible. Decide the real Lunarpunk target and align both slides. Flagged inline in PITCH-CONTENT.md too.

PITCH-CONTENT.md synced throughout. vue-tsc -b + vite build both green.

🤖 Generated with Claude Code

Implements the reviewer feedback we sorted into **Bucket 1** (objective clarity fixes) and **Bucket 2** (structural reframes). Keeps the Bitcoin-native voice — the compromise for jargon is **inline glossary tooltips**, not dumbing anything down. ## Glossary tooltips (the "don't dumb it down" compromise) - New `GlossaryTerm.vue` — dotted-underline term, reveals a one-line definition on hover **or** tap, with an optional "learn more ↗" link (Lightning → lightning.network, Nostr → nostr.com, Cypherpunk → wiki). - New `GlossedText.vue` + `glossedParts()` tokenizer — wraps glossary hits in any string. Boundary-aware, so "node" won't fire inside "Noderunners". - Wired into **every slide subtitle** (via `SlideFrame`) plus the entity-detail, ecosystem and tech card bodies. Terms defined: stack, node, Lightning, Nostr, Cypherpunk, mycelium, P&L. - Deliberately **not portaled** — the deck stage uses transforms + overflow, so a portaled popover would escape the themed `.dark` tree; the card floats inline instead. ## Bucket 1 — objective fixes - **"stack" / "node" / "Cypherpunk" / "P&L" / "Lightning"** → glossed inline (define-everywhere, not just once). - **"Pay by Lightning ⚡"** → emoji + plain gloss ("tap to pay — instant settlement, tiny fees"). - **"venue buyouts" → "venue rental · private hire"** everywhere (entity revenue + P&L line). - **"Build it once" → "Build the stack once"** and names the *it*: the shared hardware + software on decentralized protocols (Nostr + Bitcoin). - **Self-hosting line surfaced on the Lab 484 slide** (reviewer's clearest idea, previously buried on the building slide). - **P&L "Tap to expand" affordance** so the category breakdown is discoverable. ## Bucket 2 — reframes - **Title: "One soil, three flowers," not "3-in-1."** Spells out the **So·lL·unar** wordmark (the reviewer misread the lL as "1L"), labels each flower with type + place (**City · Austin**, **Farm · S. France**, **Pop-up · Travelling**), and adds a "future flowers" slot. Entities slide echoes it and names the French environment. - **Château du Faune → southern France, same property**, made explicit (your note). - **Ask → "Choose your way in"** with numbered **Option 1 / Option 2** — a decision, not a menu. - **Roadmap:** unpacked the "blueprint is the business" riddle into plain English. - **Memberships:** reframed as **three recurring-revenue streams** with revenue-at-target per tier (investor view, not a sales pitch). - **Building:** literal front/back layout ("club building in front, Cypherpunk Commons A & B in the back"). ## ⚠️ One thing to resolve before sending The memberships slide now shows **Lunarpunk Locals ≈ $14,800/mo at its 100-member target**, but the P&L conservatively models it at only **$1,500/mo ("count TBD")**. That contradiction predates this PR (it's flagged in `data.ts`), but the revenue framing makes it visible. **Decide the real Lunarpunk target and align both slides.** Flagged inline in `PITCH-CONTENT.md` too. `PITCH-CONTENT.md` synced throughout. `vue-tsc -b` + `vite build` both green. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Keeps the Bitcoin-native voice but adds a glossary layer for the
load-bearing jargon (stack, node, Lightning, Nostr, Cypherpunk,
mycelium, P&L) plus a glossedParts() tokenizer for inline tooltips.

Also the feedback-pass copy edits that live in the source of truth:
soil/flowers tagline + subtagline, Château du Faune located in
southern France, "build the stack once" names the it, venue rental
(was "venue buyouts"), real P&L spelled out, Lightning gloss + emoji.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Self-contained GlossaryTerm (dotted-underline, hover + tap, with an
optional "learn more" link) and GlossedText that wraps glossary hits in
any string. Wired into every slide subtitle via SlideFrame, plus the
entity detail, ecosystem and tech card bodies where the jargon lives.

Deliberately not portaled — the deck stage uses transforms + overflow,
so a portaled popover would escape the themed .dark tree and lose its
tokens; the card floats inline just below the term instead.

TechSlide also surfaces the self-hosting line here (reviewer found it
the clearest idea but it was buried on the building slide). Registers
the Server icon for it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Title: "One soil, three flowers" not "3-in-1" — spells out the So·lL·unar
wordmark, labels each flower with its type + place (incl. the French
farm), and shows a "future flowers" slot. Entities slide echoes the
metaphor and names the southern-France environment.

Ask: "Choose your way in" with numbered Option 1 / Option 2, framing it
as a decision rather than a menu. Roadmap: unpacks the "blueprint is the
business" riddle. Memberships: reframed as three recurring-revenue
streams with revenue-at-target per tier. Building: literal front/back
layout. P&L: adds a "Tap to expand" affordance so the breakdown is
discoverable.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Mirrors the deck copy: soil/flowers framing + wordmark note, southern
France for Château, self-hosting line, venue rental, real P&L, Lightning
gloss, choose-your-way-in ask, unpacked blueprint line, and the
memberships revenue view — including a flagged reconcile-before-sending
note on the Lunarpunk target vs. its conservative P&L amount.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feedback-clarity-pass:feedback-clarity-pass
git switch feedback-clarity-pass

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff feedback-clarity-pass
git switch feedback-clarity-pass
git rebase main
git switch main
git merge --ff-only feedback-clarity-pass
git switch feedback-clarity-pass
git rebase main
git switch main
git merge --no-ff feedback-clarity-pass
git switch main
git merge --squash feedback-clarity-pass
git switch main
git merge --ff-only feedback-clarity-pass
git switch main
git merge feedback-clarity-pass
git push origin main
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
aiolabs/sollunar-pitch!1
No description provided.