Content uses scannable formatting

Dense blocks of prose are one of the leading causes of visitors leaving a page without reading the content. Eye-tracking research consistently shows that web readers scan in an F or Z pattern — they read the first line of each paragraph and skip the rest unless the first line hooks them. Paragraphs of 8-10 sentences are read by almost no one visiting a marketing site. Breaking copy into short paragraphs (2-4 sentences), bullet lists, and subheadings is not about dumbing content down — it is about matching how humans actually read on screens. A blog post with subheadings every 300 words allows readers to jump to the section they care about; one without subheadings requires sequential reading from the beginning, which most visitors won't do.

Audit your marketing pages for long paragraphs. Any paragraph visible in the browser that runs more than 4-5 lines on a desktop viewport is a candidate for breaking.

Formatting rules for marketing copy:

- Paragraphs: 2-4 sentences maximum
- 3 or more items in a row → use a <ul> list, not a run-on sentence
- Long explanatory sections: add an <h3> subheading at least every 4-5 paragraphs
- Feature descriptions: 1-2 sentences each, not a short essay

In practice, find long description components in components/AboutSection.tsx, components/FeaturesSection.tsx, or long prose in MDX blog posts under content/blog/. Break the paragraph at each new idea or argument, not at arbitrary length. If a paragraph contains more than one claim, split it — each claim gets its own paragraph or bullet.

• ID: marketing-content-quality.content-structure.scannable-formatting

• Severity: medium

• What to look for: Count all relevant instances and enumerate each. Examine body text in marketing sections (feature descriptions, about sections, blog posts if present). Look for wall-of-text patterns: paragraphs longer than 5-6 sentences with no visual breaks, or sections that use only dense prose with no lists, subheadings, or callouts to break the content into scannable pieces. This check is specifically about marketing copy density, not code.

• Pass criteria: Marketing copy sections use a mix of short paragraphs (3-4 sentences maximum), bullet lists, or subheadings. No single visible paragraph exceeds 6 sentences. Blog posts (if present) use subheadings at least every 300-400 words.

• Fail criteria: Major marketing sections use wall-of-text prose with no visual breaks, lists, or subheadings. Paragraphs of 8+ sentences are present in key marketing sections.

• Skip (N/A) when: The project has no body copy (hero-only landing page with no explanatory text, or API-only project). Signal: all pages are under 200 words of visible body text.

• Detail on fail: Identify the specific section and describe the formatting issue. Example: "About page has a single 12-sentence paragraph with no visual breaks" or "Features section descriptions are 8-10 sentence blocks with no bullets or subheadings"

• Remediation: Web readers skim first. Dense paragraphs are skipped. Breaking content into shorter paragraphs, bullets, and subheadings increases the chance your message gets through.

  Guidelines for marketing copy:

  • Paragraphs: 2-4 sentences maximum
  • Use a bullet list when you have 3 or more items in a row
  • Add a subheading (<h3>) at least every 4-5 paragraphs in long sections

  This is not about dumbing down — it is about respecting how people read on screens.

  Review the configuration in src/ or app/ directory for implementation patterns.