examples: make the decentralized-channels demo self-explanatory#17
Merged
Conversation
Feedback from the first OXT run: it works, but a newcomer cannot tell what it
does. Add plain-language guidance without touching any working data path:
- A "? What is this?" button in the title bar opens a plain-language overview
(chHelp): what the app is, and a one-line explanation of each of the four
sections, ending with the two-machine try-it recipe.
- Hover tooltips on every control (chAddTips) so each button/field explains
itself - same affordance the main client uses.
- Plainer section headers ("1. Your channel - publish files for people to
download", etc.) and plainer captions, in place of jargon like
"immutable / content-address / DHT directory".
- Friendly empty states instead of blank lists: the transfers table and the
follow list each show a grey "do X to get started" line when empty, and the
status line reads "DHT: connecting..." until the routing table has nodes.
Pure UI text + tooltips + empty-state strings; no change to identity, feeds,
signing, or transfer logic. Verified statically (check-livecodescript: 7 files
OK; ASCII-clean; 48 balanced handlers; chHelp/chAddTips each defined once and
wired; all 17 tooltip targets are real controls). Needs an OXT pass to confirm.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01371AXB4CUUke7enHHS8okc
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to the merged BEP44 demo work (#16). First OXT run confirmed the channels app works, but a newcomer can't tell what it does — the UI leaned on jargon ("immutable", "content-address", "DHT directory"). This pass makes the demo explain itself, with no change to any working data path (identity, feeds, signing, transfers untouched).
What changed (UI text + tooltips + empty states only)
chHelp): what the app is (a file-sharing app with no server; the DHT remembers where, BitTorrent moves what), a one-liner for each of the four sections, and the two-machine try-it recipe.chAddTips) — the same affordance the main client already uses; each button/field now explains itself.Verification
check-livecodescript: 7 files OK; ASCII-clean; 48 balanced handlers;chHelp/chAddTipseach defined once and wired (button +mouseUp+chBuildcall); all 17 tooltip targets resolve to controls actually created inchBuild.🤖 Generated with Claude Code
https://claude.ai/code/session_01371AXB4CUUke7enHHS8okc
Generated by Claude Code