Skip to content

docs(world-id): rewrite prose in imperative tone - #144

Merged
murph merged 4 commits into
mainfrom
murph/world-id/imperative-tone
Jul 23, 2026
Merged

docs(world-id): rewrite prose in imperative tone#144
murph merged 4 commits into
mainfrom
murph/world-id/imperative-tone

Conversation

@SeanROlszewski

Copy link
Copy Markdown
Contributor

Iterates on #140.

Rewrites the prose across the World ID docs that #140 touched to use an imperative tone and be less verbose. This is a stylistic tightening pass only — no changes to code samples, tables, mermaid diagrams, JSX components, links, or technical facts.

What changed

  • Imperative mood + active voice ("Send a proof request" over "Your app sends a proof request", "Install IDKit" over "Make sure you're using…").
  • Cut filler and hedging ("in order to" → "to"; dropped "simply", "seamless", "you will need to", etc.).
  • Collapsed redundant / hard-wrapped sentences.

Files

  • world-id/4-0-migration.mdx
  • world-id/SKILL.md (conservative — every gate/warning/checklist item preserved)
  • world-id/credentials/11.mdx
  • world-id/from-idkit-standalone.mdx
  • world-id/idkit/credentials.mdx
  • world-id/idkit/design-guidelines.mdx
  • world-id/idkit/error-codes.mdx
  • world-id/idkit/integrate.mdx
  • world-id/idkit/signatures.mdx
  • world-id/idkit/verification-flows.mdx

cc @murph

🤖 Generated with Claude Code

Iterate on #140. Tighten prose across the World ID docs it touched:
imperative mood, active voice, and less verbosity. No changes to code
samples, tables, diagrams, links, or technical facts.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@SeanROlszewski
SeanROlszewski requested review from murph July 20, 2026 04:13
@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
world 🟢 Ready View Preview Jul 20, 2026, 4:14 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
murph
murph previously approved these changes Jul 20, 2026

@murph murph left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice change! (fix spellcheck first)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…tive-tone

# Conflicts:
#	world-id/idkit/credentials.mdx
@murph
murph merged commit 393dca7 into main Jul 23, 2026
9 checks passed
@murph
murph deleted the murph/world-id/imperative-tone branch July 23, 2026 09:00
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.

2 participants