Skip to content

Add bridge content to whitepaper page for better user guidance#17190

Merged
wackerow merged 6 commits into
ethereum:devfrom
konopkja:feature/whitepaper-bridge-content
Feb 5, 2026
Merged

Add bridge content to whitepaper page for better user guidance#17190
wackerow merged 6 commits into
ethereum:devfrom
konopkja:feature/whitepaper-bridge-content

Conversation

@konopkja
Copy link
Copy Markdown
Contributor

@konopkja konopkja commented Jan 29, 2026

Summary

This PR adds a "bridge" component to the whitepaper page that helps users arriving from investment/banking apps understand that the 2014 whitepaper is a historical document and directs them to current content.

Closes #17185

Problem

Many users land on /whitepaper/ from investment apps (Robinhood, Coinbase, etc.) expecting to learn "what Ethereum is today" but find a 2014 historical document that doesn't reflect 10+ years of protocol evolution.

Solution

Add a WhitepaperBridge component that:

  • Displays a prominent "Before you read" section above the whitepaper
  • Explains that the whitepaper is from 2014 and no longer reflects current Ethereum
  • Provides clear CTA to /learn/ for up-to-date content
  • Lists key changes since 2014 (PoS, L2s, DeFi/NFTs/DAOs, ERCs)
  • Preserves the original whitepaper below (enhancement, not replacement)

Design

Uses only existing design tokens:

  • bg-radial-a - Purple/blue radial gradient for section background
  • border-primary-low-contrast - Subtle purple border
  • bg-card-gradient-secondary - Purple-tinted gradient for context card
  • text-body, text-body-medium, text-success - Typography and icon colors
  • Existing components: Tag, ButtonLink, Card, Stack, Flex

Files Changed

  • New: src/components/WhitepaperBridge/index.tsx - The bridge component
  • Modified: src/layouts/Static.tsx - Conditionally renders bridge on whitepaper page

Visual Structure

┌─────────────────────────────────────────┐
│  Breadcrumbs                            │
├─────────────────────────────────────────┤
│  ┌───────────────────────────────────┐  │
│  │  WhitepaperBridge (NEW)           │  │
│  │  - "Before you read" tag          │  │
│  │  - "Looking to understand..."     │  │
│  │  - CTAs to /learn/ and PDF        │  │
│  │  - "What's changed" context       │  │
│  └───────────────────────────────────┘  │
├─────────────────────────────────────────┤
│  Original whitepaper content            │
│  (unchanged)                            │
└─────────────────────────────────────────┘

Test plan

  • Verify bridge displays on /whitepaper/ page
  • Test primary CTA links to /learn/
  • Test secondary CTA downloads the PDF
  • Verify whitepaper content still renders below
  • Test responsive layout (mobile/desktop)
  • Test light/dark mode

Follow-up considerations

  • i18n: Text should be moved to translation keys for 60+ supported languages
  • Analytics: Could track CTA clicks to measure effectiveness

🤖 Generated with Claude Code

Problem: Users arriving from investment/banking apps expect to learn
"what Ethereum is today" but find a 2014 historical document that
doesn't reflect 10+ years of protocol evolution.

Solution: Add a WhitepaperBridge component that:
- Acknowledges the whitepaper is a historical document
- Explains key changes since 2014 (PoS, L2s, DeFi, NFTs, ERCs)
- Provides clear CTA to /learn/ for current content
- Preserves the original whitepaper below

Design:
- Uses existing design tokens (bg-radial-a, card-gradient-secondary)
- Leverages existing components (Tag, ButtonLink, Card, Stack, Flex)
- Non-intrusive enhancement, doesn't replace whitepaper content

Closes ethereum#17185

Co-Authored-By: Claude <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Jan 29, 2026

Deploy Preview for ethereumorg ready!

Name Link
🔨 Latest commit 0f6454c
🔍 Latest deploy log https://app.netlify.com/projects/ethereumorg/deploys/6984fb3515b9470008696124
😎 Deploy Preview https://deploy-preview-17190.ethereum.it
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
7 paths audited
Performance: 58 (🔴 down 1 from production)
Accessibility: 94 (no change from production)
Best Practices: 100 (🟢 up 1 from production)
SEO: 100 (no change from production)
PWA: 59 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@konopkja
Copy link
Copy Markdown
Contributor Author

@claude why dont i see WhitepaperBridge component on the whitepaper page on preview deploy - https://deploy-preview-17190.ethereum.it/whitepaper/

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Jan 30, 2026

Claude encountered an error —— View job

Command failed: git fetch origin --depth=20 feature/whitepaper-bridge-content

I'll analyze this and get back to you.

fix(content): remove redundant copy
- Use "Section" component with spacing
- Use UnorderedList
- Adjust border color for consistency
- Prepare arrow for RTL
- Content standardization adjustments (e.g., "proof-of-work")
@github-actions github-actions Bot added the content 🖋️ This involves copy additions or edits label Feb 5, 2026
Copy link
Copy Markdown
Member

@wackerow wackerow left a comment

Choose a reason for hiding this comment

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

Looks good! Couple commits to polish things up per discussion. Non-English translations/versions can be handled in follow-up task. Pulling in

@wackerow wackerow merged commit 9a3fd01 into ethereum:dev Feb 5, 2026
2 checks passed
@wackerow wackerow mentioned this pull request Feb 5, 2026
pettinarip added a commit that referenced this pull request Feb 6, 2026
PR #17190 changed the PDF download link text from a sentence containing
"whitepaper...PDF" to "Download original PDF (2014)". Update the test
regex to match the new link text.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content 🖋️ This involves copy additions or edits

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Whitepaper page needs bridge content for users arriving from investment apps

2 participants