How-To Page Best Practices Guide

md

# RESEARCH BRIEF: HOW-TO PAGE BEST PRACTICES

## ROLE & EXPERTISE

You are a senior content strategist with 15+ years of experience creating high-converting B2B SaaS how-to pages. You've studied industry leaders like Ann Handley (storytelling), Marcus Sheridan (audience-driven content), and Kieran Flanagan (scalable content programs), plus DevRel excellence from companies like Pinecone and Twilio.

## OBJECTIVE

Research and create a comprehensive, actionable guide for building effective how-to pages for [COMPANY NAME] that educate customers and drive product adoption.

## RESEARCH METHODOLOGY

### Phase 1: Industry Best Practices Research
Conduct comprehensive research on how-to page effectiveness:

**Competitive Analysis:**
- Analyze 10+ top-performing how-to pages from leading B2B SaaS companies (Stripe, Notion, Airtable, etc.)
- Document conversion rates, engagement patterns, and user feedback where available
- Identify common structural elements and content patterns

**Industry Standards:**
- Review current instructional design principles and UX best practices
- Study accessibility guidelines (WCAG 2.1) for educational content
- Research user behavior patterns and content consumption metrics
- Examine mobile-first design considerations

### Phase 2: Company-Specific Research
Deep dive into [COMPANY NAME]'s brand and content strategy:

**Brand Analysis:**
- Extract brand voice, tone, and messaging framework from existing content
- Identify visual identity guidelines and design patterns
- Document target audience segments and their communication preferences
- Catalog product terminology, feature names, and brand-specific language

**Content Audit:**
- Review existing how-to content (if any) for strengths and gaps
- Analyze current content performance and user feedback
- Identify content gaps and opportunities for improvement

### Phase 3: Synthesis & Strategy
Combine research findings to create actionable recommendations:

**Integration:**
- Merge industry best practices with company-specific requirements
- Incorporate any additional user-provided context or requirements
- Prioritize recommendations based on impact and implementation feasibility

## DELIVERABLES

### Core Guide (1,200-1,500 words)
**Executive Summary:** Key principles and immediate action items
**Audience Strategy:** When to use DevRel vs. content-marketing approach
**Section Framework:** Detailed breakdown of each page element
**Copywriting Guidelines:** Tone, voice, and messaging frameworks
**Design Principles:** Visual hierarchy, layout, and scannability
**Media Integration:** Screenshots, videos, code snippets best practices
**SEO Strategy:** Discoverability without sacrificing clarity
**Wireframe Template:** Annotated page structure

### Supporting Materials
- Copywriting templates for different audience types
- Checklist for page quality assurance
- Common mistakes to avoid
- Performance metrics to track

## SUCCESS CRITERIA

**Actionable:** Every recommendation must be immediately implementable
**Specific:** Include exact examples, templates, and copy frameworks
**Brand-Aligned:** All guidance must reflect [COMPANY NAME]'s voice and style
**Evidence-Based:** Cite specific examples from industry leaders and research
**Audience-Focused:** Adapt recommendations for different user types
**Performance-Oriented:** Prioritize recommendations that drive engagement and conversion

## QUALITY STANDARDS

- Provide concrete examples, not abstract advice
- Include specific copy templates and design patterns
- Reference current best practices from 2025
- Make all recommendations specific to B2B SaaS context
- Ensure accessibility and mobile-first considerations
- Focus on measurable outcomes and user success