Skip to content

docs: correct install time and reword the hosted-peer caveat - #162

Open
sanity wants to merge 1 commit into
mainfrom
worktree-copy-borrowed-peer
Open

docs: correct install time and reword the hosted-peer caveat#162
sanity wants to merge 1 commit into
mainfrom
worktree-copy-borrowed-peer

Conversation

@sanity

@sanity sanity commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Problem

Ian's feedback on the current hosted-peer copy:

  1. Both the homepage note and /try claimed installing your own peer "takes a couple of minutes". It takes a few seconds. We were overstating the cost of the exact action we want visitors to take.
  2. The homepage note ended on "keeps everything on your side", which is vague about what "everything" is and where "your side" is.
  3. Neither the homepage note nor the "Ready to run your own peer?" section mentioned that private data on our peer migrates across in a single click. /try said it only inside the warning alert, so at the two points where a visitor weighs whether switching costs them their history, the migration path was invisible.

Approach

Copy edit to hugo-site/content/_index.md and hugo-site/content/try/_index.md:

  • "a couple of minutes" becomes "a few seconds" in both places.
  • "keeps everything on your side" becomes "keeps your data on your hardware", which names the concrete thing.
  • Both sections now say the private data moves across from our peer in a single click.

No layout, CSS, or shortcode changes.

Testing

hugo builds clean and the rendered public/index.html and public/try/index.html carry the new text.

[AI-assisted - Claude]

https://claude.ai/code/session_01W49hU1RFJB25AQ5X4hvyt5

The homepage and /try both said installing your own peer "takes a couple
of minutes". It takes a few seconds, so the copy was overstating the cost
of the thing we want visitors to do.

The homepage also ended on "keeps everything on your side", which is vague
about what "everything" is and what "your side" means. Say the concrete
thing instead: it keeps your data on your hardware.

Both pages now also say the private data on our peer moves across in a
single click. /try already said this inside the warning alert; the
homepage note and the "Ready to run your own peer?" section did not, so
the migration path was invisible at exactly the point a visitor is
weighing whether switching costs them their room history.

Copy only, no layout or logic change.

Claude-Session: https://claude.ai/code/session_01W49hU1RFJB25AQ5X4hvyt5
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant