Skip to content

Mobile v4 docs: tighten SuperNative introduction copy - #492

Merged
shanerbaner82 merged 3 commits into
mainfrom
docs/humanize-supernative-intro
Sep 3, 2026
Merged

Mobile v4 docs: tighten SuperNative introduction copy#492
shanerbaner82 merged 3 commits into
mainfrom
docs/humanize-supernative-intro

Conversation

@shanerbaner82

Copy link
Copy Markdown
Contributor

Summary

A copy-only pass over the first page of the v4 Architecture section, docs/mobile/4/architecture/super-native. No technical claims were added or removed.

  • Replace the seven em dashes with commas, periods, or a new sentence
  • Turn the bold-header bullet lists in "How it works" and "Why SuperNative?" into short prose paragraphs
  • Drop hype wording ("blistering speeds", "fully leverage", "couldn't be simpler", "familiar, expressive") in favour of plain, checkable statements
  • Open with what a screen is instead of what it is not
  • Trim forced triplets ("no network round-trip, no serialization overhead, and no waiting on a web view bridge")
  • Change "For Plugin Developers" to sentence case to match the other headings on the page
  • Fix the "start adopt SuperNative" typo and a trailing space

The "What SuperNative is not" section keeps its three-negation shape on purpose, since its job is to correct three specific misconceptions.

Open question

"at blistering speeds" was removed without a replacement because the page never quantifies it. If there is a real number to cite, the opening paragraph is the place for it.

Test plan

  • Review the rendered page at /docs/mobile/4/architecture/super-native
  • Confirm all in-page and cross-page links still resolve

🤖 Generated with Claude Code

https://claude.ai/code/session_0112bxu7tWLuSwy1NLdV3xwA

shanerbaner82 and others added 3 commits September 2, 2026 21:18
Rewrite the SuperNative Introduction page to read more plainly: replace
em dashes with commas and periods, turn the bold-header bullet lists in
"How it works" and "Why SuperNative?" into prose, drop hype wording like
"blistering speeds" and "fully leverage", match the plugin heading to the
sentence case used elsewhere on the page, and fix a typo in the web view
opt-out section. No technical claims were added or removed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0112bxu7tWLuSwy1NLdV3xwA
Apply the same copy pass to the remaining eight Architecture pages:
replace em dashes with commas, periods and parentheses, turn bold-header
bullet lists into prose or subheadings, trim forced triplets and
negate-then-assert phrasing, and drop hype wording. All linked heading
anchors are preserved. No technical claims were added or removed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0112bxu7tWLuSwy1NLdV3xwA
@shanerbaner82
shanerbaner82 merged commit ab565d5 into main Sep 3, 2026
3 checks passed
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