Skip to content

HELP_CENTER_ARTICLE_PLAN.md

Latest commit

 

History

History
254 lines (221 loc) · 7.12 KB

HELP_CENTER_ARTICLE_PLAN.md

File metadata and controls

254 lines (221 loc) · 7.12 KB
Raw

Help Center Article Plan

Total Articles: 15 core articles Priority: High-impact user journeys first Format: Markdown with clear headings, step-by-step instructions, screenshots placeholders

Phase 1: Getting Started (5 Articles)

1. Welcome to Serelo: Your First 5 Minutes ⭐ HIGH PRIORITY

Target: New users, first-time login Length: 800 words Covers:

  • What is Serelo?
  • Quick overview of dashboard
  • Understanding projects, sources, and posts
  • First action: Create your first project Outcome: User understands core concepts and creates first project

2. Creating Your First Project ⭐ HIGH PRIORITY

Target: New users Length: 600 words Covers:

  • Step-by-step project creation
  • Naming best practices
  • What projects are for (organizing content by topic/client)
  • Project settings and management Outcome: User successfully creates and manages projects

3. Uploading Source Files

Target: Users ready to add content sources Length: 700 words Covers:

  • Supported file types (DOCX, PDF, MD, CSV)
  • File size limit (20MB)
  • Upload methods (drag & drop, click to browse)
  • Understanding parsing status (uploaded → parsing → parsed)
  • Troubleshooting parsing errors Outcome: User successfully uploads and parses documents

4. Generating Your First Post ⭐ HIGH PRIORITY

Target: Users ready to create content Length: 1000 words Covers:

  • Writing an effective topic/brief
  • Selecting sources (optional)
  • Choosing voice presets
  • Understanding generation time (45-90 seconds)
  • Viewing and using generated content Outcome: User generates first post successfully

5. Understanding Your Dashboard

Target: New users exploring the platform Length: 800 words Covers:

  • Dashboard widgets explanation
  • Usage statistics
  • Recent activity feed
  • Quick actions
  • Navigation overview Outcome: User confidently navigates Serelo

Phase 2: Core Features (5 Articles)

6. Writing Effective Briefs for Best Results

Target: Users wanting better generation quality Length: 900 words Covers:

  • Brief structure and best practices
  • How to use sources effectively
  • Voice preset selection guide
  • Custom instructions tips
  • Common mistakes to avoid Outcome: User writes high-quality briefs

7. Voice Presets Explained

Target: Users exploring tone options Length: 800 words Covers:

  • All 11 voice presets with examples
  • FREE vs paid voices
  • When to use each voice
  • Voice upgrade benefits
  • Combining voices with custom instructions Outcome: User selects appropriate voice for content

8. Bulk Generation with CSV

Target: Agency users, power users Length: 1000 words Covers:

  • Plan requirements (Starter: 100, Pro: 500, Business: 1000)
  • CSV format and template download
  • Column descriptions (topic, voice, custom_instructions, source_filenames)
  • Upload and monitoring progress
  • Troubleshooting CSV errors Outcome: User successfully bulk generates content

9. Internal Linking for SEO

Target: SEO-focused users Length: 900 words Covers:

  • Creating link opportunities
  • CSV import for bulk links
  • Anchor text strategies
  • Linking configuration options
  • Best practices for SEO Outcome: User implements internal linking strategy

10. Publishing to Social Media

Target: Users with social accounts Length: 800 words Covers:

  • Connecting Facebook and LinkedIn
  • OAuth process
  • Publishing vs scheduling
  • Character limits by platform
  • Managing connected accounts Outcome: User publishes to social media

Phase 3: Account & Billing (3 Articles)

11. Understanding Plans and Pricing

Target: Users evaluating plans Length: 1000 words Covers:

  • FREE plan (10 posts, 4 voices)
  • STARTER plan (R399, 50 posts, bulk 100)
  • PRO plan (R999, 200 posts, bulk 500)
  • BUSINESS plan (R1999, 500 posts, bulk 1000)
  • ENTERPRISE plan (R3999, unlimited)
  • Feature comparison matrix
  • Usage tracking and quotas Outcome: User understands plan differences and selects appropriate tier

12. How to Upgrade or Downgrade Your Plan

Target: Users changing plans Length: 700 words Covers:

  • Upgrade process (immediate)
  • Downgrade process (at period end)
  • Cancellation (remains active until cycle end)
  • Prorated billing
  • What happens to your data
  • Reactivating cancelled subscriptions Outcome: User confidently manages subscription

13. Managing Your Usage and Quotas

Target: Users tracking consumption Length: 600 words Covers:

  • Viewing current usage
  • Posts remaining this month
  • Billing cycle dates
  • What happens when quota exceeded
  • Usage best practices
  • Upgrade prompts Outcome: User monitors and manages usage effectively

Phase 4: Troubleshooting & FAQ (2 Articles)

14. Troubleshooting Common Issues

Target: Users encountering problems Length: 1200 words Covers:

  • Parsing Errors:
    • Image-only PDFs
    • Corrupted files
    • Large files
  • Generation Errors:
    • "Already generating" error
    • Quota exceeded
    • Insufficient sources
    • [NEEDS_INPUT] signal
  • Publishing Errors:
    • Disconnected accounts
    • Character limits
    • Permission issues
  • Authentication Issues:
    • Token expiration
    • Login problems Outcome: User resolves common issues independently

15. Frequently Asked Questions

Target: All users Length: 1000 words Covers:

  • General:
    • How does Serelo work?
    • Is my content original?
    • What happens to my sources?
  • Billing:
    • Payment methods accepted
    • Refund policy
    • Currency (ZAR)
  • Technical:
    • File format support
    • Generation time
    • API access
  • Features:
    • Team collaboration
    • Custom integrations
    • Export options Outcome: User finds quick answers to common questions

Article Writing Guidelines

Structure

  1. Title: Clear, action-oriented (e.g., "How to Upload Source Files")
  2. Introduction: 2-3 sentences explaining what user will learn
  3. Prerequisites: What user needs before starting (if applicable)
  4. Step-by-Step Instructions: Numbered steps with clear actions
  5. Screenshots/Visuals: Placeholders marked as [SCREENSHOT: Description]
  6. Tips & Best Practices: Highlighted boxes
  7. Troubleshooting: Common issues at the end
  8. Related Articles: Links to 2-3 related guides
  9. Still Need Help?: CTA to contact support

Tone

  • Clear and professional
  • Action-oriented language
  • Assume beginner knowledge
  • Use exact terminology from codebase
  • Include specific numbers (character limits, file sizes, etc.)

Technical Accuracy

  • All information verified against HELP_CENTER_CONTENT_RESEARCH.md
  • No assumptions or placeholders
  • Real error messages from code
  • Exact API endpoints when relevant
  • Correct plan names and pricing

Next Steps

  1. ✅ Create article plan (this document)
  2. ⏳ Write Phase 1 articles (Getting Started)
  3. ⏳ Write Phase 2 articles (Core Features)
  4. ⏳ Write Phase 3 articles (Account & Billing)
  5. ⏳ Write Phase 4 articles (Troubleshooting & FAQ)
  6. ⏳ Set up Docusaurus
  7. ⏳ Add articles to Docusaurus
  8. ⏳ Deploy Help Center

Estimated Time: 3-4 days for all 15 articles