React Docs Voice & Style

Universal Rules

• Capitalize React terms when referring to the React concept in headings or as standalone concepts:
  • Core: Hook, Effect, State, Context, Ref, Component, Fragment
  • Concurrent: Transition, Action, Suspense
  • Server: Server Component, Client Component, Server Function, Server Action
  • Patterns: Error Boundary
  • Canary: Activity, View Transition, Transition Type
  • In prose: Use lowercase when paired with descriptors: "state variable", "state updates", "event handler". Capitalize when the concept stands alone or in headings: "State is isolated and private"
  • General usage stays lowercase: "the page transitions", "takes an action"
• Product names: ESLint, TypeScript, JavaScript, Next.js (not lowercase)
• Bold for key concepts: state variable, event handler
• Italics for new terms being defined: event handlers
• Inline code for APIs: useState, startTransition, <Suspense>
• Avoid: "simple", "easy", "just", time estimates
• Frame differences as "capabilities" not "advantages/disadvantages"
• Avoid passive voice and jargon