final contenet/text ux plan md

This commit is contained in:
IGNY8 VPS (Salman)
2025-12-25 06:00:37 +00:00
parent 98a7ee3fa9
commit cb9f45a701

980
UX-TEXT-IMPROVEMENT-PLAN.md Normal file
View File

@@ -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**