Merge branch 'main' of https://git.igny8.com/salman/igny8

UX-TEXT-IMPROVEMENT-PLAN.md

@@ -0,0 +1,980 @@
+# IGNY8 UX Text Improvement Plan
+
+**Date:** December 25, 2025  
+**Objective:** Update all user-facing text across the IGNY8 application to be more intuitive, friendly, and helpful for non-technical users.
+
+**Scope:** Frontend text only - labels, headers, descriptions, tooltips, and help text  
+**Out of Scope:** Backend status values, database fields, API responses, code-level changes
+
+---
+
+## 1. DASHBOARD PAGE
+
+### Header Area
+- **Main Title:** Add welcoming context
+  - Current: "Dashboard"
+  - New: "Your Content Creation Dashboard"
+
+- **Last Updated Label:** Make more conversational
+  - Current: "Last updated"
+  - New: "Last checked: [timestamp]"
+
+- **Refresh Button:** Add tooltip
+  - New tooltip: "Click to get the latest updates on your content creation progress"
+
+### Main Banner
+- **Subtitle:** Add explanation below current heading
+  - New: "Your complete toolkit for finding topics, creating content, and publishing it to your site - all automated"
+
+- **Sites Counter:** Clarify fraction meaning
+  - Current: "2/5 Sites"
+  - New: "2 of 5 Sites Active"
+
+### Your Progress Card
+- **Card Title:** More relatable heading
+  - Current: "Your Progress"
+  - New: "Your Content Journey"
+
+- **Description:** Simplify language
+  - Current: "Track your content creation workflow completion"
+  - New: "See how far you've come in creating and publishing content"
+
+- **Progress Bar Label:** Add explanation with context
+  - New: "Overall Completion: 83% - You're making great progress!"
+  - Add micro-explanation: "(This shows your progress from keywords through to published content)"
+
+### Metric Cards
+Each card needs enhanced descriptions:
+
+- **Site & Sectors:**
+  - Current: "Industry & sectors configured"
+  - New: "Niches you're targeting - Industry & sectors set up"
+
+- **Keywords:**
+  - Current: "Keywords added from opportunities"
+  - New: "Search terms to target - Keywords added from research"
+
+- **Clusters:**
+  - Current: "Keywords grouped into clusters"
+  - New: "Topic groups - Keywords organized by theme"
+
+- **Ideas:**
+  - Current: "Content ideas and outlines"
+  - New: "Article outlines ready - Ideas and outlines created"
+
+- **Content:**
+  - Current: "Content pieces + images created"
+  - New: "Articles created - Written content + images ready"
+
+- **Published:**
+  - Current: "Content published to site"
+  - New: "Live on your site - Articles published and active"
+
+### Quick Actions Area
+Make titles action-oriented with helpful descriptions:
+
+- **Keyword Research:**
+  - New title: "Find Keywords to Rank For"
+  - New description: "Search for topics your audience wants to read about"
+
+- **Clustering & Ideas:**
+  - New title: "Organize Topics & Create Outlines"
+  - New description: "Group keywords and create article plans"
+
+- **Content Generation:**
+  - New title: "Write Articles with AI"
+  - New description: "Generate full articles ready to publish"
+
+- **Internal Linking:**
+  - New title: "Connect Your Articles"
+  - New description: "Automatically link related articles for better SEO"
+
+- **Content Optimization:**
+  - New title: "Make Articles Better"
+  - New description: "Improve readability, keywords, and search rankings"
+
+- **Image Generation:**
+  - New title: "Create Article Images"
+  - New description: "Generate custom images for your content"
+
+- **Automation:**
+  - New title: "Run Everything Automatically"
+  - New description: "Set up schedules to create and publish content on its own"
+
+- **Prompts:**
+  - New title: "Customize Your AI Writer"
+  - New description: "Create custom instructions for how AI writes your content"
+
+---
+
+## 2. ADD KEYWORDS PAGE
+
+### Page Header
+- **Title:** More descriptive
+  - Current: "Add Keywords"
+  - New: "Find & Add Keywords to Target"
+
+- **Description:** Clearer instruction
+  - Current: "Select a sector from the dropdown above to enable adding keywords..."
+  - New: "Pick a topic area first, then add keywords - You need to choose what you're writing about before adding search terms to target"
+
+### Sector Selector
+- **Label:** Add context
+  - Current: "Sector: All Sectors"
+  - New: "What topic area? - All Sectors"
+
+- **Helper Text:** Add below selector
+  - New: "Select a niche or topic - This tells our AI what type of content you create"
+
+### Table Headers
+Replace technical jargon with plain language:
+
+- **KEYWORD** → "Search Term"
+  - Context: "what people actually search for"
+
+- **SECTOR** → "Topic Area"
+  - Context: "the category"
+
+- **VOLUME** → "How Often Searched"
+  - Context: "what this metric means"
+
+- **DIFFICULTY** → "Competition Level"
+  - Context: "easier to understand than difficulty"
+
+- **COUNTRY** → "Target Location"
+  - Context: "clearer purpose"
+
+- **STATUS:** Add tooltip
+  - Tooltip: "Added means Selected for your content plan"
+
+### Show Filters Button
+- **Tooltip:** Add explanation
+  - New tooltip: "Click to filter keywords by search volume, difficulty, or other details"
+
+### Bulk Actions
+- **Label:** Simplify
+  - Current: "Bulk Actions"
+  - New: "Do Multiple at Once"
+  - Tooltip: "Select keywords and perform actions on all of them together"
+
+---
+
+## 3. SITES MANAGEMENT PAGE
+
+### Page Header
+- **Title:** Friendlier
+  - Current: "Sites Management"
+  - New: "Your Websites"
+
+- **Description:** Add helpful context
+  - New: "Manage all your websites here - Add new sites, configure settings, and track content for each one"
+
+### Add Site Button
+- **Button Text:** More specific
+  - Current: "Add Site"
+  - New: "+ Add Another Website"
+  - Tooltip: "Connect a new WordPress or Shopify site to create content for it"
+
+### Filter Dropdowns
+Make more conversational:
+
+- **All Types** → "Show All Types"
+- **All Hosting** → "Show All Hosting"
+- **All Status** → "Show All Status"
+
+- **Helper Text:** Add below filters
+  - New: "Filter by site type, hosting provider, or active status"
+
+### Site Card Buttons
+Clarify each button's purpose:
+
+- **Dashboard Button:**
+  - New text: "View Site Dashboard"
+  - Tooltip: "See overview and statistics for this site"
+
+- **Content Button:**
+  - New text: "Manage Content"
+  - Tooltip: "Add, edit, or view all articles for this site"
+
+- **Settings Button:**
+  - New text: "Configure Site"
+  - Tooltip: "Update connection details and publishing settings"
+
+### Active/Inactive Status
+- **Explanation:** Add near toggle
+  - New: "Active sites can receive new content. Inactive sites are paused."
+
+---
+
+## 4. THINKER (AI PROMPTS MANAGEMENT) PAGE
+
+### Page Header
+- **Title:** Replace abstract name
+  - Current: "AI Prompts Management"
+  - New: "Customize Your AI Writer"
+
+- **Description:** Remove jargon
+  - Current: "Configure AI prompt templates..."
+  - New: "Tell our AI how you want it to write - Create custom instructions and templates for different types of content"
+
+### Tab Labels
+Make tabs clearer:
+
+- **Prompts** → "Writing Styles"
+- **Author Profiles** → "Writing Voices"
+- **Strategies** → "Content Strategies"
+- **Image Testing** → "Test Image Settings"
+
+### Prompts Sub-Sections
+Add explanations to each section:
+
+- **Planner Prompts:**
+  - New title: "AI Instructions for Planning"
+  - Explanation: "These instructions tell our AI how to organize your keywords into topics and create outlines"
+
+- **Clustering Prompt:**
+  - New title: "How to Organize Keywords"
+  - Description: "This tells our AI how to group related keywords into topic clusters"
+
+- **Ideas Generation Prompt:**
+  - New title: "How to Create Article Outlines"
+  - Description: "This tells our AI how to generate article ideas and outlines for each topic cluster"
+
+- **Writer Prompts:**
+  - New section header: "AI Instructions for Writing"
+  - Explanation: "These control how our AI writes your full articles"
+
+### Action Buttons
+- **Reset to Default** → "Restore Original"
+- **Save Prompt** → "Save My Custom Instructions"
+
+---
+
+## 5. PLANNER PAGE - KEYWORDS VIEW
+
+### Page Header
+- **Title:** More descriptive
+  - New: "Organize Your Keywords"
+
+- **Description:** Clearer purpose
+  - New: "Group keywords into topic clusters and plan your content - Get keywords ready to write about"
+
+### Status Alerts
+Simplify pipeline readiness message:
+
+- **Current:** "Pipeline readiness at 22% - Most keywords need clustering..."
+- **New:** "You're 22% ready to start writing - Next step: Group your keywords by topic (36 keywords are ready to organize)"
+
+### Top Statistics Bar
+- **UNMAPPED Label:**
+  - Current: "UNMAPPED"
+  - New: "READY TO ORGANIZE"
+
+- **Add Tooltips:** Explain each stat
+
+### Bulk Actions
+- **Button Text:** Simplify
+  - Current: "Bulk Actions"
+  - New: "Do Multiple at Once"
+  - Tooltip: "Select keywords and apply actions to all of them together"
+
+### Table Headers
+Replace with plain language:
+
+- **KEYWORD** → "Search Term"
+- **SECTOR** → "Topic Area"
+- **VOLUME** → "Monthly Searches"
+- **CLUSTER** → "Grouped Under" or "Topic Group"
+- **DIFFICULTY** → "Competition Level"
+- **COUNTRY** → "Target Country"
+- **STATUS** → "Prep Status"
+- **CREATED** → "Date Added"
+
+### Import Button
+- **Button Text:**
+  - Current: "Import"
+  - New: "+ Import More Keywords"
+
+---
+
+## 6. PLANNER PAGE - CLUSTERS VIEW
+
+### Tab Area
+- **Keywords Tab:** Add label
+  - New: "Keywords (individual terms)"
+
+- **Clusters Tab:** Rename
+  - New: "Topics (keyword groups)"
+
+- **Explanation:** Add at top
+  - New: "See your keyword groups - Clusters are groups of related keywords organized by topic"
+
+### Cluster Display
+- **Keyword Count:** Make clearer
+  - Current: "5"
+  - New: "5 keywords in this group"
+
+---
+
+## 7. WRITER PAGE (CONTENT QUEUE)
+
+### Page Header
+- **Title:** More specific
+  - Current: "Content Queue"
+  - New: "Write Your Articles"
+
+- **Description:** Clearer purpose
+  - New: "Create and manage all your article content - Write, review, and publish articles one by one or all at once"
+
+### Status Alerts
+Improve clarity:
+
+- **Current:** "1 tasks in queue - Content generation pipeline is active..."
+- **New:** "You have 1 article waiting to be written - Our AI is ready to create it. High completion rate (82%) - 9 pieces of content are ready to review"
+
+### Tab Names
+Make states clearer:
+
+- **Queue** → "Ready to Write"
+  - Context: "these are articles waiting"
+
+- **Drafts** → "Finished Drafts"
+  - Context: "these are completed"
+
+- **Images** → "Article Images"
+  - Context: "more specific"
+
+- **Review** → "Review Before Publishing"
+  - Context: "clearer action"
+
+### Bulk Actions
+- **Label:** Simplify
+  - Current: "Bulk Actions"
+  - New: "Do Multiple at Once"
+
+### Table Headers
+Update to plain language:
+
+- **TITLE** → "Article Title"
+- **SECTOR** → "Topic Area"
+- **CLUSTER** → "Topic Group"
+- **TYPE** → "Content Type"
+- **STRUCTURE** → "Article Format"
+- **STATUS** → "Current State"
+- **WORD COUNT** → "Word Count"
+
+### Status Display Labels
+Add context (display only, not field values):
+
+- **"Completed"** display as: "Done - Ready to Review"
+- **"Queued"** display as: "Waiting to be Written"
+- **"Failed"** display as: "Error - Needs Help"
+
+### Content Type Help
+Add explanation popup:
+
+- **Post:** "Blog article (standard format)"
+- **Page:** "Standalone page (no categories)"
+- **Guide:** "Comprehensive how-to guide"
+- **Tutorial:** "Step-by-step instructional content"
+
+---
+
+## 8. AUTOMATION PAGE
+
+### Page Header
+- **Title:** More exciting
+  - Current: "AI Automation Pipeline"
+  - New: "Automate Everything"
+
+- **Description:** Clearer benefit
+  - New: "Set your content on automatic - Let our AI create and publish content on a schedule"
+
+### Status Badge
+Add enthusiasm and clarity:
+
+- **Current:** "Ready to Run - 34 items in pipeline"
+- **New:** "Ready to Go! 34 items waiting - Everything is queued up and ready for the next run"
+
+### Schedule Display
+Make more conversational:
+
+- **Current:** "Daily at 02:00:00 | Last: Never | Est: 5 credits"
+- **New:** "Runs every day at 2:00 AM | Last run: Never | Uses about 5 credits per run"
+
+### Pipeline Statistics
+- **Header:** Add above stats
+  - New: "Here's what's in your automation pipeline:"
+
+- **Update Labels:**
+  - "Keywords 46" → "46 Search Terms (waiting to organize)"
+  - "Clusters 4" → "4 Topic Groups (ready for ideas)"
+  - "Ideas 16" → "16 Article Ideas (waiting to write)"
+  - "Content 10" → "10 Articles (in various stages)"
+  - "Images 10" → "10 Images (created and waiting)"
+
+### Pipeline Stage Names
+Replace technical names with clear actions:
+
+#### Stage 1: Keywords → Clusters
+- **New Name:** "ORGANIZE KEYWORDS"
+- **Description:** "Group related search terms into topic clusters"
+
+#### Stage 2: Clusters → Ideas
+- **New Name:** "CREATE ARTICLE IDEAS"
+- **Description:** "Generate article titles and outlines for each cluster"
+
+#### Stage 3: Ideas → Tasks
+- **New Name:** "PREPARE WRITING JOBS"
+- **Description:** "Convert ideas into tasks for the AI writer"
+
+#### Stage 4: Tasks → Content
+- **New Name:** "WRITE ARTICLES"
+- **Description:** "AI generates full, complete articles"
+
+#### Stage 5: Content → Image Prompts
+- **New Name:** "CREATE IMAGE DESCRIPTIONS"
+- **Description:** "Generate descriptions for AI to create images"
+
+#### Stage 6: Image Prompts → Images
+- **New Name:** "GENERATE IMAGES"
+- **Description:** "AI creates custom images for your articles"
+
+#### Stage 7: Manual Review + Publishing
+- **New Name:** "REVIEW & PUBLISH ⚠️"
+- **Description:** "Review 3 articles before they go live (manual approval needed)"
+
+#### Final: Published
+- **New Name:** "LIVE ON YOUR SITE"
+- **Description:** "Articles are now published and visible"
+
+### Action Buttons
+- **Configure Button:**
+  - New text: "⚙️ Adjust Settings"
+  - Tooltip: "Change when this automation runs and how many credits it uses"
+
+- **Run Now Button:**
+  - Keep text but add tooltip: "Start the automation immediately instead of waiting for the scheduled time"
+
+---
+
+## 9. ACCOUNT SETTINGS PAGE
+
+### Page Header
+- **Title:** More friendly
+  - Current: "Account Settings"
+  - New: "Your Account Info"
+
+- **Description:** Clearer purpose
+  - New: "Keep your information updated - Your account name, email, and billing address"
+
+### Account Information Section
+- **Section Title:**
+  - New: "Basic Account Details"
+
+- **Field Labels:**
+  - **Account Name** → "Your Account Name"
+    - Helper: "This is how you'll see your account (for you only)"
+  
+  - **Account Slug** → "Account URL Name"
+    - Helper: "Used in web addresses (usually matches your company name)"
+  
+  - **Billing Email** → "Email for Receipts"
+    - Helper: "Where invoices and billing updates will be sent"
+
+### Billing Address Section
+- **Section Title:**
+  - New: "Where to Send Invoices"
+
+- **Intro Text:** Add above fields
+  - New: "Tell us your official business address for billing"
+
+- **Field Labels:**
+  - **Address Line 1** → "Street Address"
+  - **Address Line 2** → "Apartment, Suite, etc. (optional)"
+  - **State/Province** → "State or Province"
+  - **Postal Code** → "ZIP or Postal Code"
+
+---
+
+## 10. TEAM MANAGEMENT PAGE
+
+### Page Header
+- **Title:** Simpler
+  - Current: "Team Management"
+  - New: "Your Team"
+
+- **Description:** Clearer purpose
+  - New: "Manage who can access your account - Add team members and control what they can do"
+
+### Tab Navigation
+Add context to each tab:
+
+- **Users** → "Team Members (Active)"
+- **Invitations** → "Pending Invites (Waiting to Join)"
+- **Access Control** → "Permissions (What they can do)"
+
+### Users Tab - Column Headers
+- **Name** → "Member Name"
+- **Email** → "Email Address"
+- **Status** → "Account Status"
+- **Role** → "Permission Level"
+- **Joined** → "Date Joined"
+- **Last Login** → "Last Active"
+- **Actions:** Add tooltip
+  - Tooltip: "Remove this person's access"
+
+### Invite Button
+- **Button Text:**
+  - Current: "Invite Team Member"
+  - New: "+ Invite Someone"
+  - Tooltip: "Send an invitation to someone to join your team"
+
+### Permission Levels (Access Control Tab)
+Add plain explanations:
+
+- **Admin:** "Full access to everything"
+- **Member:** "Can create and edit content"
+- **Viewer:** "Can only view reports"
+
+---
+
+## 11. PLANS & BILLING PAGE
+
+### Page Header
+- **Title:** More specific
+  - Current: "Plans & Billing"
+  - New: "Your Subscription"
+
+- **Description:** Clearer purpose
+  - New: "Manage your plan and payments - View what's included, upgrade, or buy more credits"
+
+### Current Plan Section
+- **Section Title:**
+  - Current: "Your Current Plan"
+  - New: "What You're Using Now"
+
+- **Plan Name Enhancement:**
+  - "Growth" → "Growth Plan (Our most popular)"
+
+- **Call to Action:**
+  - Current: "Select a plan to unlock full access"
+  - New: "Want more? Upgrade your plan for more content limits and features"
+
+### Plan Features Card
+- **Card Title:**
+  - Current: "Included Features"
+  - New: "What's in Your Plan"
+
+- **Feature List - Add Context:**
+  - "5 Sites" → "5 Websites - You can manage up to 5 websites"
+  - "1000 Keywords" → "1,000 Keywords - You can track up to 1,000 search terms per month"
+  - "3000 Credits" → "3,000 Credits - Credits are used to run automation and create content"
+  - "300K Words" → "300,000 Words - About how much content you can generate per month"
+  - "200 Clusters" → "200 Topic Groups - You can organize keywords into up to 200 clusters"
+  - "900 Images" → "900 Images - AI can generate up to 900 images per month"
+
+### Tab Names
+Make purposes clearer:
+
+- **Current Plan** → Keep (clear enough)
+- **Plan Limits** → "Your Limits (What you can do)"
+- **Credits** → "Credits & Balance (How much you have left)"
+- **Purchase/Upgrade** → "Buy More (Get more credits or upgrade)"
+- **History** → "Billing History (Past invoices and charges)"
+
+### Action Buttons
+- **Purchase Credits:**
+  - New text: "+ Buy More Credits"
+  - Tooltip: "Add credits to your account for more content generation"
+
+- **View Limits:**
+  - New text: "See Your Limits"
+  - Tooltip: "Check how much of each feature you're using"
+
+---
+
+## 12. USAGE & ANALYTICS PAGE
+
+### Page Header
+- **Title:** Simpler
+  - Current: "Usage & Analytics"
+  - New: "Your Usage"
+
+- **Description:** Clearer purpose
+  - New: "See how much you're using - Track your credits, content limits, and API activity"
+
+### Stats Cards at Top
+Add explanations to each:
+
+- **Current Balance:**
+  - Display: "Credits Left: 835"
+  - Explanation: "You have 835 credits available"
+
+- **Used This Month:**
+  - Display: "Credits Used This Month: 1,165"
+  - Explanation: "How many credits you've spent so far"
+
+- **Monthly Allocation:**
+  - Display: "Your Monthly Limit: 3,000"
+  - Explanation: "Total credits you get each month"
+
+- **Usage %:**
+  - Display: "39% Used"
+  - Explanation: "You've used 39% of your monthly credits. You have 61% left"
+
+### Tab Names
+Add context:
+
+- **Plan Limits & Usage** → "Your Limits & Usage (What you're using)"
+- **Credit Activity** → "Credit History (Where credits go)"
+- **API Usage** → "API Activity (Technical requests)"
+
+### Account Limits Section
+- **Section Title:**
+  - New: "Your Account Limits"
+
+- **Intro Text:** Add above list
+  - New: "Here's how much of each feature you're using:"
+
+- **Display Format - Add Context:**
+  - "Sites" → "Websites: 2 of 5 Used"
+    - Explanation: "You're using 40% of your site limit"
+  
+  - "Team Users" → "Team Members: 2 of 3 Used"
+    - Explanation: "You can add 1 more person"
+  
+  - "Keywords" → "Search Terms: 46 of 1,000 Used"
+    - Explanation: "You're using 5% of your keyword limit"
+  
+  - "Clusters" → "Topic Groups: 4 of 200 Used"
+    - Explanation: "Plenty of room for more topics"
+
+### Monthly Usage Limits
+- **Section Title:**
+  - New: "What You Can Create This Month"
+
+- **Intro Text:** Add above charts
+  - New: "These reset on the 1st of each month:"
+
+- **Item Labels:**
+  - "Content Ideas" → "Article Ideas: 105 of 900 Used"
+  - "Content Words" → "Article Words: 41,377 of 300,000 Used"
+  - "Basic Images" → "AI Images: 81 of 900 Used"
+
+---
+
+## 13. PROFILE SETTINGS PAGE
+
+### Page Header
+- **Title:** Friendlier
+  - Current: "Profile Settings"
+  - New: "Your Profile"
+
+- **Description:** Clearer purpose
+  - New: "Update your personal settings - Your name, preferences, and notification choices"
+
+### Personal Information Section
+- **Section Title:**
+  - Current: "Personal Information"
+  - New: "About You"
+
+- **Field Labels:** (Keep mostly the same, clear enough)
+  - "Phone" → "Phone Number (optional)"
+
+### Preferences Section
+- **Section Title:**
+  - New: "How You Like It"
+
+- **Field Labels with Explanations:**
+  - **Timezone** → "Your Timezone"
+    - Explanation: "We use this to show you times that match your location"
+  
+  - **Language** → "Language"
+    - Explanation: "The language we'll use to talk to you"
+
+### Notifications Section
+- **Section Title:**
+  - New: "What You Want to Hear About"
+
+- **Intro Text:** Add above options
+  - New: "Choose what emails you want to receive:"
+
+- **Options:**
+  - **Email Notifications** → "Important Updates"
+    - Explanation: "Get notified about important changes to your account"
+  
+  - **Marketing Emails** → "Tips & Product Updates (optional)"
+    - Explanation: "Hear about new features and content tips"
+
+### Save Button
+- **Button Text:**
+  - Current: "Save Changes"
+  - New: "✓ Save My Settings"
+
+---
+
+## 14. PUBLISHING SETTINGS PAGE
+
+### Page Header
+- **Title:** More specific
+  - Current: "Publishing Settings"
+  - New: "Where to Publish"
+
+- **Description:** Clearer purpose
+  - New: "Set up automatic publishing - Tell us where your content should go"
+
+### Default Publishing Destinations
+- **Section Title:**
+  - Current: "Default Publishing Destinations"
+  - New: "Where Should Articles Go?"
+
+- **Description:**
+  - Current: "Choose which platforms..."
+  - New: "Choose which platforms get your articles - You can pick multiple"
+
+- **Explanation:** Add below description
+  - New: "When you publish an article, it will go to all the platforms you check here"
+
+- **Checkbox Labels:**
+  - "IGNY8 Sites" → "Publish to My Sites (using IGNY8)"
+  - "WordPress" → "Publish to WordPress (your self-hosted WordPress site)"
+  - "Shopify" → "Publish to Shopify (your Shopify store)"
+
+### Auto-Publish Settings
+- **Section Title:**
+  - Current: "Auto-Publish"
+  - New: "Automatic Publishing"
+
+- **Description:**
+  - New: "Publish articles without asking me"
+
+- **Checkbox Label:**
+  - New: "Automatically publish articles when they're finished and reviewed"
+
+- **Explanation:** Add below checkbox
+  - New: "When you turn this on, articles will publish to your site right away. You can still review them first if you want"
+
+### Auto-Sync Settings
+- **Section Title:**
+  - Current: "Auto-Sync"
+  - New: "Keep Everything Updated"
+
+- **Description:**
+  - New: "Automatically sync articles between platforms"
+
+- **Checkbox Label:**
+  - New: "Automatically update articles on all my platforms if I make changes"
+
+- **Explanation:** Add below checkbox
+  - New: "When you edit an article, this updates it everywhere - on your site, WordPress, etc."
+
+### Publishing Rules
+- **Section Title:**
+  - New: "Advanced Publishing Rules"
+
+- **Description:**
+  - New: "Set specific rules for different types of content"
+
+- **Add Rule Button:**
+  - New: "+ Add a Publishing Rule"
+
+- **Example Text:** Add
+  - New: "Example: Publish blog posts to WordPress but guides to your main site"
+
+---
+
+## 15. IMPORT / EXPORT PAGE
+
+### Coming Soon Banner
+- **Title:**
+  - Current: "Coming Soon"
+  - New: "Coming Soon: Manage Your Data"
+
+- **Description:**
+  - Current: "Data management"
+  - New: "Import and Export Your Content - Backup your keywords, articles, and settings. Move your content to other platforms. Download everything safely."
+
+- **Feature List:** Add what will be available
+  - "✓ Export your keywords as a file (backup or share)"
+  - "✓ Export all your articles in different formats"
+  - "✓ Import keywords from other sources"
+  - "✓ Backup and restore your entire account"
+  - "✓ Download your settings and configurations"
+
+---
+
+## 16. HELP & DOCUMENTATION PAGE
+
+### Page Header
+- **Description Enhancement:**
+  - Current: Basic description
+  - New: "Learn How to Use IGNY8 - Step-by-step guides and answers to common questions"
+
+### Table of Contents
+- **Section Title:**
+  - Current: "Table of Contents"
+  - New: "What Do You Want to Learn?"
+
+- **Section Names - Reorganize and Rename:**
+  - "Getting Started" → "I'm New - Help Me Get Started!"
+  - "Planner Module" → "How to Organize Keywords"
+  - "Writer Module" → "How to Write Content"
+  - "Automation Setup" → "Set Up Automation"
+  - "Frequently Asked Questions" → "Common Questions Answered"
+
+### Quick Start Guide
+- **Introduction:**
+  - Current: "Welcome to IGNY8! Follow these steps to get started with content creation:"
+  - New: "Let's Get You Creating Content! Follow these simple steps:"
+
+### Step Descriptions
+Make each step clearer:
+
+- **Set Up Your Site:**
+  - New: "Step 1: Connect Your Website"
+  - Explanation: "Tell IGNY8 which website you want to create content for"
+
+- **Discover Keywords:**
+  - New: "Step 2: Find Search Terms to Target"
+  - Explanation: "Search for keywords people are looking for in your topic area"
+
+(Continue pattern for all steps)
+
+### Module Descriptions
+- **"Planner Module"** → "Organizing Phase"
+- **"Writer Module"** → "Writing Phase"
+- **"Automation"** → "Automatic Phase"
+
+Add plain-English descriptions for each.
+
+---
+
+## 17. SIDEBAR NAVIGATION
+
+### Section Headers
+Make more intuitive:
+
+- **SETUP** → "GET STARTED"
+  - Context: "clearer that this is initial setup"
+
+- **WORKFLOW** → "CREATE CONTENT"
+  - Context: "clearer about main activities"
+
+- **ACCOUNT** → "MANAGE ACCOUNT"
+  - Context: "already clear"
+
+- **SETTINGS** → "CONFIGURATION"
+  - Context: "clearer than just SETTINGS"
+
+- **HELP & DOCS** → "HELP & LEARNING"
+  - Context: "friendlier tone"
+
+### Menu Item Names
+Clarify actions:
+
+- **"Add Keywords"** → "Find Keywords"
+  - Context: "clearer action"
+
+- **"Thinker"** → "AI Writer Setup"
+  - Context: "explains what it is"
+
+- **"Planner"** → "Organize Keywords"
+  - Context: "explains the action"
+
+- **"Writer"** → "Write Articles"
+  - Context: "clearer"
+
+- **"Automation"** → "Automate Everything"
+  - Context: "clearer value"
+
+### Icons
+- **Enhancement:** Add small text labels on hover explaining each icon
+
+---
+
+## KEY PRINCIPLES APPLIED
+
+### 1. Remove Jargon
+- Replace technical terms with everyday language
+- Example: "Pipeline readiness" → "You're ready to start writing"
+
+### 2. Add Context
+- Explain WHY users need to do something, not just HOW
+- Example: Add explanations to all setting fields
+
+### 3. Clarify Status
+- Explain what status badges and messages mean
+- Example: "Queued" → "Waiting to be Written"
+
+### 4. Use Friendly Tone
+- "Let's get started" instead of "Configure"
+- Make the interface conversational
+
+### 5. Add Micro-Explanations
+- One-line helper text on key elements
+- Tooltips for complex concepts
+
+### 6. Action-Oriented Labels
+- "Write Articles" not "Writer Module"
+- Focus on what users will accomplish
+
+### 7. Number + Meaning
+- "39% Used - You have 61% left" not just "39%"
+- Always provide context for percentages and numbers
+
+### 8. Tooltip Helpers
+- Hover explanations for complex concepts
+- Help users understand without cluttering the interface
+
+### 9. Simple Descriptions
+- Use active voice and clear actions
+- Avoid passive construction
+
+### 10. Progressive Disclosure
+- Hide advanced features but make them discoverable
+- Don't overwhelm new users
+
+---
+
+## IMPLEMENTATION NOTES
+
+### What to Change
+- All user-facing text in the frontend
+- Labels, headers, descriptions, tooltips, button text
+- Help text, placeholder text, empty states
+- Success/error messages (display text only)
+- Tab names, section titles, card titles
+
+### What NOT to Change
+- Backend status field values in the database
+- API response structures
+- URL slugs or routes
+- Code variable names
+- Database column names
+- Internal logic or calculations
+- Architecture patterns
+
+### Testing Approach
+1. Review each page against this plan
+2. Ensure all text matches the intended user-friendly tone
+3. Verify tooltips appear correctly
+4. Check that explanations are helpful without being verbose
+5. Test with non-technical users for feedback
+
+---
+
+## SUCCESS METRICS
+
+After implementation, users should experience:
+
+- ✓ Reduced confusion about what features do
+- ✓ Fewer support questions about basic navigation
+- ✓ Increased confidence in using advanced features
+- ✓ Better understanding of their progress and status
+- ✓ More intuitive onboarding experience
+- ✓ Clearer sense of what actions to take next
+
+---
+
+**End of Plan**