Chapters

01Introduction
02Clarifying Your "Why"
03Setting Goals
04Focused Strategy
05Building Your Customer Education Team
06Content Creation
6AVideos
6BHelp Articles & Guides
6CIn-app Guidance
6DCourses
6ECertification
07Distribution
7AKnowledge Base & Help Centres
7BAcademy Programs
7CLive Training
08Metrics to Track
09FAQs
10Editable Business Case Template
Introduction

Chapter 6B

Help Articles & Guides

Enabling self-service learning through clear, accessible documentation

Help articles are the silent heroes for CEd team - always available, instantly helpful, and infinitely scalable. They serve as a knowledge foundation that empowers both customers and support teams, providing consistent answers to common questions while reducing repetitive inquiries. When used along with videos, help articles become force multipliers, allowing your team to focus on complex issues while customers' routine questions are easily answered.

1.1 Why Help Articles Are Essential

What you're building: A scalable self-service knowledge base that reduces support load and serves every learning style.

1. Serving Different Learning Styles

Some prefer visual and auditory learning through videos, but some individuals prefer to learn through reading. Text-based guides and articles help cater to these diverse preferences.

3. SEO and Discovery Benefits

Well-written articles don't just help existing customers - they attract new ones. Help content ranks in search results, bringing prospects to your site while showcasing your expertise.

2. Massive Cost Savings

Each help article can deflect hundreds of support tickets. Companies report 15-30% reduction in support costs when implementing comprehensive documentation.

2.1 Key Components of Effective Help Articles

What you're building: Articles that are genuinely helpful, not just technically accurate.

Great help articles share common DNA that makes them genuinely helpful, not just technically accurate:

1. Problem-First Structure

·Start with the user's problem, not your solution
·Use headers that match how customers search
·Include "troubleshooting" and "common issues" sections

2. Scannable Format

·Short paragraphs (2-3 sentences max)
·Bulleted lists for steps
·Bold key actions and important warnings
·Visual hierarchy with proper headings

3. Visual Support

·Annotated screenshots for every major step
·GIFs for complex interactions
·Diagrams for conceptual explanations
·Videos embedded for visual learners

4. Action-Oriented Writing

·Use imperative voice ("Click the Settings button")
·Number steps clearly
·Include what users should see after each action
·Add troubleshooting tips for common mistakes

5. Contextual Help

·Link to related articles
·Include prerequisites upfront
·Provide next steps after completion
·Add tags for easy discovery

3.1 Tools for Creating Help Articles

What you're choosing: The right tool for your documentation workflow.

Clueso

Quick Overview: AI-powered platform that automatically generates step-by-step documentation from screen recordings, complete with screenshots and professional formatting.

Best For: Teams wanting to create comprehensive documentation quickly without manual screenshot capture or formatting.

Key Features:

  • Automatic article generation from recordings
  • Smart screenshot capture with annotations
  • GIF creation for complex workflows
  • Rich text, HTML, and Markdown export
  • Built-in knowledge base hosting
  • Easy updates when UI changes
  • SEO-optimized formatting

Scribe

Quick Overview: Browser extension that captures your clicks and automatically creates step-by-step guides with screenshots.

Best For: Teams needing quick process documentation with minimal editing.

Key Features:

  • Automatic screenshot capture during workflow
  • Basic step-by-step guide creation
  • Simple text descriptions
  • PDF and web embed options
  • Browser-based capture

Limitations:

  • Limited to browser-based workflows
  • Basic formatting options
  • No video creation capabilities
  • Manual editing for complex workflows
  • Limited customization options
  • No built-in knowledge base

Tango

Quick Overview: Chrome extension that creates interactive guides by recording your workflow and generating documentation.

Best For: Teams creating internal process documentation and SOPs.

Key Features:

  • Workflow recording with automatic steps
  • Interactive guide creation
  • Basic screenshot annotations
  • Shareable links
  • Simple editing interface

Limitations:

  • Chrome-only functionality
  • Limited export formats
  • Basic visual customization
  • No video capabilities
  • Requires manual updates
  • Limited branding options
FeatureCluesoScribeTango
Time to Create5-15 minutes10-20 minutes10-20 minutes
Recording TypeScreen + UploadsBrowser onlyChrome only
Video Creation
GIF Support✓ Automatic
Export FormatsHTML, Markdown, Rich TextPDF, WebWeb links
Knowledge BaseBuilt-in
AnnotationsAdvancedBasicBasic
UpdatesEasy refreshManualManual

Choose Clueso when:

·You need both video and written documentation
·Your product includes desktop applications
·You want professional formatting automatically
·You need to update content frequently
·Visual elements (GIFs, annotations) are important
·You're building a comprehensive knowledge base
·You need multiple export formats

Choose Scribe when:

·You only need basic step-by-step guides
·Your workflows are primarily web-based
·You want quick documentation with minimal editing
·Budget is a primary concern
·You need simple PDF exports
·Your team prefers browser extensions

Choose Tango when:

·You're documenting internal processes
·Your team uses Chrome exclusively
·You need interactive guides
·You want shareable web links
·Simple documentation is sufficient
·You're creating SOPs for team training
← Previous[6A] Videos
Next →[6C] In-app Guidance