Moment

first_encounter

Onboarding, setup, first-run. Clarity above all.

Weights

ContentRX adjusts how strictly each standard is enforced in this moment. Cross-reference any standard by its ID to read the full rule.

Emphasized — flag more aggressively

  • CLR-01 — Use plain language. Avoid jargon, technical terms, or insider language unless the audience requires it.
    First-time users have zero context. Plain language is critical.
  • CLR-03 — Use short sentences. Aim for 15-20 words per sentence. Sentences over 25 words should almost always be split.
    Keep sentences short — cognitive load is highest on first use.
  • ACC-01 — Write descriptive link text. Never use 'click here' or 'learn more' as standalone links.
    New users rely on clear link text to orient themselves.
  • PRF-11
    Dismissive language is most harmful during onboarding — users have no context yet.

Relaxed — minor deviations acceptable

  • GRM-03 — Use exclamation points sparingly. Never use more than one at a time, and never in error messages or alerts.
    An exclamation in a welcome message is warmer, not louder.

Example pairs

Concrete "this, not that" examples observed in 1 style guides. Attribution is inline — see /ethics for the commitment and /sources for the full list.

  • VT-02 · short_ui_copyCC-BY-NC-ND-4.0

    Not this. The user should complete the setup.

    But this. Finish setting up your account.

    Talk to the person, not about them. Second person lands warmer. Mailchimp · Voice and tone — Personal pronouns


← The content model