Site: cut the setup guide roughly in half - #121
Merged
Merged
Conversation
938 words to 521. The guide was written like documentation when it should
read like a checklist — a reader who has answered four questions wants the
next thing to do, not a paragraph about it.
Every step is now a title and at most one line. "Restart OBS" needed no
sentence explaining what restarting is; "Plug in and tap Trust" needed
"unlock the phone first, and use a data cable" and nothing more. The
closing step became a single line under the list, since "you're set" is
not a step.
The "what you'll need" box is now one sentence rather than a bordered
panel with a heading and bullets: it is a packing list, not a section.
The condition tags ("Windows", "USB") now hide once the steps are
filtered. They exist so the unfiltered, no-JavaScript page still reads
correctly; with filtering on, every visible step matches the answers, so
each tag was restating a question from a few inches above.
Steps are also tighter vertically — smaller markers, less padding between
them — so a typical configuration fits about a screen and a half instead
of three.
Release-Skip: true
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PSuQicA9NrKWwpgzY6SvhA
Deploying lenslink with
|
| Latest commit: |
6c67c44
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://96252810.lenslink.pages.dev |
| Branch Preview URL: | https://claude-setup-guide-concise.lenslink.pages.dev |
The page was a hero section followed by a content section, so between the lede and the first question sat 56px of the hero's bottom padding plus 64px of the next section's top padding — a 139px hole, with a divider line drawn across the middle of what is one idea. The title exists to introduce the questions; there is no reason for a page break between them. Now one section: 48px from the header to the title (was 72), 36px from the lede to the first question (was 139). On a 1100px viewport the title, all four questions and the first two steps land on one screen, which is what a guided setup should look like when it opens. Release-Skip: true Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PSuQicA9NrKWwpgzY6SvhA
"Four questions, then only the steps that apply to you" described what the page visibly is: four questions, followed by steps. A reader who can see the controls does not need to be told they are controls. Its second half was worth keeping — that the answers live in the address bar, so a configuration can be sent to someone — but not at the top, where nobody yet has a configuration to share. It moves to the closing line, where it becomes an offer rather than a preamble. On a phone all four questions, the needs line and the first two steps now sit above the fold; on a desktop, the first four steps do. Release-Skip: true Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PSuQicA9NrKWwpgzY6SvhA
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.
What & why
938 words → 521. The guide was written like documentation when it should
read like a checklist: someone who has answered four questions wants the next
thing to do, not a paragraph about it.
explaining what restarting achieves; "Plug in and tap Trust" is now "Unlock
the phone first, and use a data cable" and nothing else.
the list, pointing at the Status field and the fuller docs.
and bullets: "You'll need OBS 32+, an iPhone or iPad on iOS 15+, a USB data
cable, iTunes." A packing list, not a section.
unfiltered, no-JavaScript page still reads correctly; with filtering on,
every visible step already matches your answers, so each tag was restating a
question from a few inches above.
configuration is about a screen and a half instead of three.
Nothing was dropped that a reader acts on: the same 11–12 steps appear for a
given configuration, with the same links.
How it was tested
python3 build.py→ 16 pages;python3 check-links.py→ 0 broken links.tags correctly hidden while filtered, and the needs line reading as one
sentence.
<main>, before andafter.
Release-Skip: true;site/matches none of the release paths.🤖 Generated with Claude Code
https://claude.ai/code/session_01PSuQicA9NrKWwpgzY6SvhA
Generated by Claude Code