documentation-hub 5.7.2

package/USER_GUIDE.md

@@ -0,0 +1,1173 @@
+# Documentation Hub - Complete User Guide
+
+Welcome to **Documentation Hub**, your professional desktop application for processing and managing Word documents with ease. This guide will walk you through every feature and help you make the most of the application.
+
+## Table of Contents
+
+1. [Getting Started](#getting-started)
+2. [Navigation Overview](#navigation-overview)
+3. [Dashboard](#dashboard)
+4. [Working with Sessions](#working-with-sessions)
+5. [Sessions Page](#sessions-page)
+6. [Document Processing](#document-processing)
+7. [Documents Page](#documents-page)
+8. [Analytics](#analytics)
+9. [Search](#search)
+10. [Plugins](#plugins)
+11. [Projects & Team](#projects--team)
+12. [Profile](#profile)
+13. [Settings & Customization](#settings--customization)
+14. [Keyboard Shortcuts](#keyboard-shortcuts)
+15. [Tips & Best Practices](#tips--best-practices)
+16. [How Settings Link to Document Processing](#how-settings-link-to-document-processing)
+
+---
+
+## Getting Started
+
+### First Launch
+
+When you first launch Documentation Hub, you'll see the **Dashboard** - your central hub for managing document processing sessions and viewing productivity statistics.
+
+### Understanding the Interface
+
+The application features a modern, clean interface with three main areas:
+
+- **Sidebar** (Left): Primary navigation menu
+- **Header** (Top): Breadcrumb navigation, current time, quick actions, and theme switcher
+- **Main Content Area** (Center): Your workspace for each page
+
+---
+
+## Navigation Overview
+
+### Sidebar Navigation
+
+The sidebar on the left is your primary navigation tool and can be collapsed/expanded by clicking the circular button on its edge.
+
+**Main Navigation Items:**
+
+- **Dashboard** - Your home base showing session overview and statistics
+- **Active Sessions** - Dynamically appears under Dashboard when you have open sessions
+  - Each active session is listed with a small dot icon
+  - Click the X button to close a session (appears on hover)
+- **Sessions** - View and manage all your document processing sessions
+- **Analytics** - Visual charts and productivity insights
+- **Team** - Collaborate with team members
+- **Documents** - Browse and manage your document library
+- **Plugins** - Extend functionality with add-ons
+- **Search** - Powerful document search across all sessions
+
+**Bottom Navigation:**
+
+- **Profile** - Your personal information and settings
+- **Settings** - Application preferences and customization
+
+### Header Bar
+
+The header provides contextual information and quick actions:
+
+- **Breadcrumbs** - Shows your current location (clickable for quick navigation)
+- **Page Description** - Brief explanation of the current page
+- **Clock Widget** - Real-time clock display
+- **Lightning Bolt Icon** - Opens Command Palette (Ctrl+K)
+- **Theme Switcher** - Toggle between Light and Dark modes
+
+### Hidden Features
+
+- **Easter Egg**: Click the "D" logo in the sidebar 5 times quickly to open developer tools
+
+---
+
+## Dashboard
+
+The Dashboard is your starting point and provides an at-a-glance view of your productivity.
+
+### Statistics Overview
+
+Four main metric cards display your all-time statistics:
+
+1. **Documents Processed** - Total documents you've processed
+2. **Hyperlinks Checked** - Total hyperlinks validated
+3. **Feedback Imported** - Total feedback comments imported
+4. **Time Saved** - Estimated time saved (calculated at 101 seconds per hyperlink)
+
+Each card shows:
+
+- Current total value
+- Today's activity count
+- Comparison to yesterday (trending up/down/no change)
+
+### Quick Actions
+
+Two buttons in the top-right corner:
+
+- **New Session** - Create a new document processing session
+- **Load Session** - Open a previously saved session
+
+### Recent Sessions
+
+Below the statistics, you'll see a list of your most recently accessed sessions, showing:
+
+- Session name (editable)
+- Number of documents in the session
+- Last modified time
+- Current status (active/inactive)
+
+Click any session to open it and continue working.
+
+---
+
+## Working with Sessions
+
+Sessions are the core concept in Documentation Hub. A session is a workspace where you group related documents for batch processing.
+
+### Creating a New Session
+
+1. Click **New Session** from the Dashboard or sidebar
+2. Enter a descriptive session name
+3. Click **Create Session**
+
+You'll be taken to the session workspace immediately.
+
+### Session Workspace
+
+The session workspace features multiple tabs for different aspects of your work:
+
+#### Session Tab (Main)
+
+**Statistics Cards:**
+
+- Documents processed
+- Hyperlinks checked
+- Feedback imported
+- Time saved (with breakdown)
+
+**Document Upload Area:**
+
+- Drag and drop Word documents (.docx files) into the designated area
+- Or click **Select Files** to browse and choose documents
+- Multiple files can be added at once
+
+**Document List:**
+Each document in your session displays:
+
+- File name
+- File size
+- Status icon:
+  - Clock icon = Pending (not yet processed)
+  - Spinning loader = Processing (currently being processed)
+  - Green checkmark = Completed (processing finished)
+  - Red alert = Error (processing failed)
+- Action buttons:
+  - **Process** - Start processing the document (only for pending documents)
+  - **Process Documents** - Process all pending documents at once
+  - **Open in Word** - Opens the processed document in Microsoft Word (only for completed documents)
+  - **X** - Remove document from session
+
+#### Processing Options Tab
+
+Configure which operations to apply to your documents:
+
+**Available Operations:**
+
+- **Fix Content IDs** - Appends content identifiers to hyperlinks
+- **Fix Internal Hyperlinks** - Validates and corrects internal document links
+- **Update TOC Hyperlinks** - Refreshes Table of Contents hyperlinks
+- **Validate Document Styles** - Ensures consistent style formatting
+- **Validate Header2 Tables** - Checks formatting of tables under Header 2 sections
+- **Check External Hyperlinks** - Validates all external URLs
+- **Import Feedback** - Processes and imports document comments
+- **Apply List Formatting** - Standardizes bullet points and numbered lists
+- **Apply Table Uniformity** - Ensures consistent table formatting
+- **Apply Table Shading** - Applies background colors to table rows
+
+**Table Shading Options:**
+
+- Configure different colors for Header2 tables vs. other tables
+- Use the color picker dialogs to choose custom colors
+
+Toggle each option on/off using the switches. Your selections are saved with the session.
+
+#### Styles Editor Tab
+
+Customize the visual appearance of your processed documents:
+
+**Main Text Customization:**
+
+- Font family
+- Font size
+- Font color
+- Bold/italic styling
+- Character spacing
+- Line height
+
+**Secondary Text Customization:**
+
+- Same options as main text but for secondary elements
+- Descriptions and supporting content
+
+**Live Preview:**
+Shows how your text styling will appear in the document.
+
+**List Bullet Settings:**
+
+- Choose between standard bullets or custom characters
+- Configure indentation and spacing
+- Set bullet colors
+
+**Quick Save Button:**
+
+- Saves all style preferences to the session
+
+#### Replacements Tab
+
+Set up automatic text replacements to apply during processing:
+
+1. Enter text to find in the "Find" field
+2. Enter replacement text in the "Replace With" field
+3. Click **Add Rule** to save
+4. View all active replacement rules in the list below
+5. Remove rules by clicking the trash icon
+
+Useful for:
+
+- Standardizing terminology
+- Correcting common typos
+- Updating product names or abbreviations
+
+#### Tracked Changes Tab
+
+View a detailed diff of what changed in your documents after processing:
+
+- Side-by-side comparison of before and after
+- Highlighted changes show exactly what was modified
+- Useful for auditing and understanding the processing impact
+
+### Saving and Closing Sessions
+
+Click **Save and Close Session** (top-right) to:
+
+- Save all session settings and document states
+- Close the session workspace
+- Return to the Dashboard
+
+Your session is automatically saved and can be reopened later from the Dashboard or Sessions page.
+
+---
+
+## Sessions Page
+
+The Sessions page provides a comprehensive overview of all your document processing sessions, both active and archived.
+
+### Accessing the Sessions Page
+
+Click **Sessions** in the sidebar to view all your sessions in one place.
+
+### View Modes
+
+Switch between two view styles using the toggle buttons in the top-right:
+
+**Grid View:**
+
+- Card-based layout showing sessions in a grid
+- Shows 3 columns on large screens, 2 on medium, 1 on small
+- Best for visual browsing and quick identification
+
+**List View:**
+
+- Compact list format with additional details
+- Shows extended statistics inline
+- Best for viewing many sessions at once
+
+### Search and Filter
+
+Use the search box at the top to quickly find sessions by name. Results filter in real-time as you type.
+
+### Session Cards
+
+Each session card displays:
+
+**Header:**
+
+- Folder icon
+- Session name
+- Status badge (active/inactive in green or gray)
+- Delete button (appears on hover)
+
+**Statistics:**
+
+- Number of documents in the session
+- Total time saved (in minutes)
+
+**Metadata:**
+
+- Creation date
+- Last modified date
+
+**Additional Info (List View Only):**
+
+- Documents processed count
+- Hyperlinks checked count
+- Feedback imported count
+- Time saved breakdown
+
+### Session Actions
+
+**Opening a Session:**
+
+- Click anywhere on the session card
+- The session opens in the Session Workspace
+- Recent activity updates automatically
+
+**Deleting a Session:**
+
+- Hover over the session card
+- Click the trash icon in the top-right corner
+- Confirm deletion in the dialog that appears
+- **Warning**: Deletion is permanent and cannot be undone
+
+### Creating New Sessions
+
+Click the **New Session** button in the top-right corner to create a session directly from this page.
+
+### Empty State
+
+If you don't have any sessions yet, you'll see a helpful message prompting you to create your first session.
+
+---
+
+## Document Processing
+
+### Processing Workflow
+
+1. **Add Documents** - Upload Word files to your session
+2. **Configure Options** - Choose which operations to apply
+3. **Process** - Click the Process button on individual documents or "Process Documents" for batch processing
+4. **Review** - Check the Tracked Changes tab to see what changed
+5. **Open** - Click "Open in Word" to view and use the processed document
+
+### Processing Status
+
+Watch the status icons to track progress:
+
+- **Pending** (Clock) - Waiting to be processed
+- **Processing** (Spinning) - Currently being processed
+- **Completed** (Green Check) - Successfully processed and ready
+- **Error** (Red X) - Processing failed (check error message)
+
+### Toast Notifications
+
+During processing, you'll see helpful notifications:
+
+- **Processing Started** - Shows which operations are being applied
+- **Processing Complete** - Confirms success and reminds you to open the document
+- **Processing Failed** - Explains what went wrong
+
+### Opening Processed Documents
+
+Once processing is complete (green checkmark):
+
+1. Click the **green "Open in Word" button**
+2. The document opens in Microsoft Word
+3. Review the changes and save as needed
+4. The original file remains untouched (backups are created automatically)
+
+---
+
+## Documents Page
+
+The Documents page provides a centralized library view of all documents across all your sessions.
+
+### Accessing the Documents Page
+
+Click **Documents** in the sidebar to browse your entire document collection.
+
+### Search and Filtering
+
+**Search Box:**
+
+- Located at the top with a magnifying glass icon
+- Search by document name or session name
+- Results update instantly as you type
+
+**Status Filter:**
+
+- Filter by document processing status
+- Options: All, Completed, Pending, Error
+- Shows count for each status category
+- Click any filter button to apply
+
+### Document Cards
+
+Each document is displayed in a card showing:
+
+**Document Information:**
+
+- File icon (colored by status)
+- Document name
+- Session name (which session it belongs to)
+- File path (where it's stored)
+
+**Status Indicators:**
+
+- Green checkmark = Completed
+- Yellow clock = Pending
+- Red alert = Error
+
+**Quick Actions:**
+
+- **Open in Word** - Opens the document in Microsoft Word (completed documents only)
+- **Show in Folder** - Opens File Explorer to the document's location
+- Hover over any document for action buttons
+
+### Viewing Options
+
+Documents are organized in a clean list format with:
+
+- Session grouping (documents from the same session appear together)
+- Status badges for quick visual identification
+- File metadata display
+
+### Empty States
+
+If you don't have any documents yet, you'll see a message encouraging you to:
+
+- Create a new session
+- Add documents to existing sessions
+
+### Use Cases
+
+The Documents page is ideal for:
+
+- Finding a specific document across multiple sessions
+- Reviewing all completed documents at once
+- Identifying documents with processing errors
+- Accessing documents without remembering which session they're in
+- Quick file management and organization
+
+### Integration with Sessions
+
+- Click on any document's session name to jump directly to that session
+- Documents reflect real-time status updates
+- Changes in sessions are immediately visible in the Documents page
+
+---
+
+## Analytics
+
+The Analytics page provides powerful visualizations of your productivity over time.
+
+### View All Modes
+
+Choose between three time ranges:
+
+- **Daily** - Last 30 days of activity
+- **Weekly** - Last 12 weeks of activity
+- **Monthly** - Last 12 months of activity
+
+Switch views using the buttons at the top.
+
+### Statistics Summary
+
+Four metric cards show your all-time totals:
+
+- Documents Processed
+- Hyperlinks Checked
+- Feedback Imported
+- Time Saved
+
+### Charts
+
+**Documents Processed Over Time:**
+
+- Line chart showing document processing trends
+- Helps identify busy periods and productivity patterns
+
+**Activity Breakdown:**
+
+- Bar chart showing all metrics side-by-side
+- Compare documents, hyperlinks, feedback, and time saved
+
+**Performance Comparison:**
+
+- Multi-line chart showing all metrics on one graph
+- Spot correlations and trends across different activities
+
+### Resetting Statistics
+
+The **Reset All Stats** button (top-right) clears all historical data:
+
+- Use with caution - this cannot be undone
+- Confirmation dialog ensures you don't accidentally reset
+
+---
+
+## Search
+
+The Search page lets you find documents across all sessions with powerful filtering.
+
+### Basic Search
+
+1. Type your query in the large search box
+2. Results appear instantly as you type
+3. Uses fuzzy search to find partial matches
+
+### Advanced Filters
+
+Click the **Filter icon** in the search box to reveal:
+
+**Status Filter:**
+
+- All Status - Show everything
+- Completed - Only processed documents
+- Pending - Only unprocessed documents
+- Error - Only failed documents
+
+**Session Filter:**
+
+- Dropdown to select a specific session
+- Or choose "All Sessions" to search everywhere
+
+### Keyboard Navigation
+
+Efficient keyboard controls for power users:
+
+- **↑ Arrow Up** - Move selection up
+- **↓ Arrow Down** - Move selection down
+- **Enter** - Open selected document's session
+
+The selected result is highlighted and auto-scrolls into view.
+
+### Search Results
+
+Each result shows:
+
+- Document name
+- Session name it belongs to
+- File path
+- Status icon
+- Right arrow to open
+
+Click any result to jump to that document's session.
+
+---
+
+## Plugins
+
+The Plugins page is your marketplace for extending Documentation Hub's functionality.
+
+### Plugin Categories
+
+Browse by category:
+
+- **All Plugins** - Everything available
+- **Document** - Document processing enhancements
+- **UI & Theme** - Visual customization
+- **Integration** - External service connections
+- **Automation** - Workflow automation tools
+
+### Plugin Statistics
+
+Three cards at the top show:
+
+- **Installed** - Number of plugins you've installed
+- **Active** - Number of plugins currently enabled
+- **Available** - Total plugins in the marketplace
+
+### Plugin Cards
+
+Each plugin displays:
+
+**Information:**
+
+- Name and description
+- Version number
+- Author (DocHub Team or Community)
+- Category icon
+- Star rating (out of 5)
+- Download count
+- Verified badge (for official plugins)
+
+**Actions:**
+
+- **Install** - Download and install the plugin
+- **Enable/Disable Toggle** - Turn the plugin on/off
+- **Uninstall** - Remove the plugin completely
+
+### Popular Plugins
+
+- **PDF Export** - Export documents as PDFs
+- **Cloud Sync** - Sync to cloud storage
+- **Advanced Analytics** - Extended reporting features
+- **Theme Builder** - Create custom themes
+- **Batch File Renamer** - Auto-rename processed files
+
+### Managing Plugins
+
+1. **To Install**: Click the Install button on any uninstalled plugin
+2. **To Enable**: Toggle the switch to the "on" position (blue)
+3. **To Disable**: Toggle the switch to the "off" position (gray)
+4. **To Uninstall**: Click the trash icon or Uninstall button
+
+Installed plugins appear at the top of the list.
+
+---
+
+## Projects & Team
+
+The Projects and Team pages provide collaboration features for team-based workflows.
+
+### Projects Page
+
+The Projects page helps you manage multiple projects with team collaboration.
+
+**Accessing the Projects Page:**
+
+- Click **Projects** in the sidebar (visible under Team navigation item)
+
+**Project View Options:**
+
+- **Grid View** - Visual card layout with project tiles
+- **List View** - Detailed table format with all project information
+
+**Project Information:**
+Each project card displays:
+
+- Project name and description
+- Current status (Planning, In Progress, Review, etc.)
+- Progress bar showing completion percentage
+- Team member count
+- Last updated timestamp
+- Color-coded status indicator
+
+**Project Actions:**
+
+- Click any project to view details
+- Create new projects with the "New Project" button
+- Search projects by name or description
+- Filter by status or team assignment
+
+**Use Cases:**
+
+- Coordinate document processing across multiple projects
+- Track team progress on large documentation initiatives
+- Organize sessions by project context
+- Monitor project timelines and milestones
+
+### Team Page
+
+The Team page facilitates collaboration with colleagues.
+
+**Accessing the Team Page:**
+
+- Click **Team** in the sidebar
+
+**Team Features:**
+
+- View all team members
+- See who's working on which sessions
+- Track collective productivity
+- Coordinate document processing workflows
+- Share sessions and processing configurations
+
+**Collaboration Benefits:**
+
+- Consistent document processing across the team
+- Shared style templates and replacement rules
+- Centralized statistics and analytics
+- Coordinated project timelines
+
+---
+
+## Profile
+
+The Profile page contains your personal information and account settings.
+
+### Accessing Your Profile
+
+Click **Profile** in the bottom section of the sidebar.
+
+### Profile Information
+
+**Personal Details:**
+
+- Profile picture or avatar
+- Display name
+- Email address
+- User role or title
+- Account creation date
+
+**Quick Stats:**
+
+- Your personal contribution to team metrics
+- Individual productivity statistics
+- Recent activity summary
+
+**Account Actions:**
+
+- Edit profile information
+- Update contact details
+- Change password (if applicable)
+- Manage account preferences
+- View account activity history
+
+**Integration:**
+Your profile integrates with:
+
+- Session history (shows your sessions)
+- Global statistics (tracks your contributions)
+- Team collaboration (displays your role)
+
+### Privacy & Security
+
+- Profile visibility settings
+- Data privacy preferences
+- Connected accounts and integrations
+- Session sharing permissions
+
+---
+
+## Settings & Customization
+
+The Settings page offers extensive customization options, organized into logical sections.
+
+### Navigation
+
+The left sidebar provides quick access to all setting categories:
+
+- **Account** - Profile information
+- **Customization** - Appearance and Typography
+- **System** - Language, Updates, API Connections, Storage, Submit Idea
+
+Use the search box at the top to quickly find specific settings.
+
+### Profile Settings
+
+Manage your personal information:
+
+- First Name
+- Last Name
+- Email Address
+
+**Quick Actions:**
+
+- Export Settings - Save all your preferences to a file
+- Import Settings - Load preferences from a backup file
+- Save Changes - Apply your edits
+
+### Appearance Settings
+
+**Theme Mode:**
+Choose between Light and Dark themes:
+
+- **Light** - Bright, clean interface for daytime use
+- **Dark** - Easy on the eyes for low-light environments
+
+**Interface Density:**
+Control spacing and compactness:
+
+- **Comfortable** - Spacious, relaxed layout
+- **Compact** - Tighter spacing, more content visible
+- **Minimal** - Maximum density, minimal padding
+
+**Accent Color:**
+Choose from 8 preset colors or create a custom color:
+
+- Blue, Purple, Green, Orange, Pink, Cyan, Indigo
+- **Custom** - Opens a color picker for any color you want
+
+**Visual Effects:**
+
+- **Glass morphism effects** - Blur and transparency effects
+- **Smooth animations** - Transitions and micro-interactions
+
+Toggle each on/off based on your preference and system performance.
+
+**Custom Theme Colors:**
+For advanced users, enable custom colors to override:
+
+- Primary color
+- Background color (text color auto-adjusts for contrast)
+- Header color (text color auto-adjusts)
+- Sidebar color (text color auto-adjusts)
+- Border color
+
+Click each color swatch to open the color picker dialog.
+
+### Typography Settings
+
+**Live Preview:**
+See your changes in real-time with sample text.
+
+**Quick Presets:**
+Four one-click presets:
+
+- **Reading** - Comfortable for long-form content
+- **Compact** - Dense for information-heavy screens
+- **Presentation** - Large, bold for displays
+- **Default** - Reset to factory settings
+
+**Font Settings:**
+
+- **Family** - Choose from 11 fonts including Inter, Roboto, Poppins, monospace fonts, and even Webdings for fun
+- **Size** - 12px to 20px slider
+- **Weight** - Light, Regular, Medium, Semibold, Bold
+- **Style** - Normal or Italic
+
+**Spacing Settings:**
+
+- **Letter Spacing** - Tight to Wide (-0.05em to 0.1em)
+- **Line Height** - Compact to Spacious (1.0 to 2.0)
+
+All changes update the preview in real-time.
+
+### Language & Region Settings
+
+**Language:**
+Choose your display language:
+
+- English (US)
+- Español (Spanish)
+- 中文 (Mandarin Chinese)
+
+**Timezone:**
+Select from US timezones and common international zones:
+
+- US: Hawaii, Alaska, Pacific, Mountain, Central, Eastern
+- International: UTC, London, Paris, Cairo, Moscow, Mumbai, Beijing, Tokyo, Sydney
+
+**Date Format:**
+Choose how dates are displayed:
+
+- MM/DD/YYYY (US format)
+- DD/MM/YYYY (European format)
+- YYYY-MM-DD (ISO format)
+
+### Updates Settings
+
+**Current Version:**
+Displays the installed version number.
+
+**Check for Updates:**
+Click the button to manually check for new versions:
+
+- Shows "Checking..." while searching
+- Displays "Update available" if a new version is found
+- Shows "You are up to date" if you're current
+
+**Download Update:**
+When an update is available:
+
+- Click to download (progress bar shows percentage)
+- "Install & Restart" button appears when download completes
+- Application closes, updates, and reopens automatically
+
+**Auto-Update Settings:**
+
+- **Auto-update on launch** - Automatically check when starting the app
+- **Check for pre-releases** - Include beta versions in update checks
+
+Toggle these on/off based on your preference.
+
+### API Connections Settings
+
+Configure external service integrations.
+
+**Hyperlink Processing:**
+
+- **PowerAutomate Dictionary URL** - API endpoint for hyperlink metadata
+  - Paste your PowerAutomate workflow URL
+  - Real-time validation shows any issues
+  - Auto-sanitizes encoded characters
+  - Green checkmark = valid, red alert = invalid
+  - Detailed error messages guide you to fix problems
+
+**Feedback & Reporting:**
+
+- **Bug Report API URL** - Where bug reports are sent
+- **Submit Idea API URL** - Where feature suggestions are sent
+
+Leave as default to use email fallback.
+
+### Submit Idea Settings
+
+Share your feature ideas with the development team:
+
+1. **Title for Idea** - Brief, descriptive title
+2. **Why is this needed / Who would this benefit?** - Detailed explanation
+3. Click **Submit Idea** to send
+
+Your idea is sent via the configured API or email. Confirmation appears when successful.
+
+### Storage Settings
+
+Manage your data and storage:
+
+**Storage Used:**
+
+- Visual progress bar shows usage (e.g., 2.4 GB of 10 GB = 24%)
+- Percentage displayed prominently
+
+**Data Management:**
+
+- **Clear Cache** - Free up space by removing temporary files
+- **Export Settings & Data** - Backup everything to a JSON file
+- **Import Settings & Data** - Restore from a backup file
+- **Delete Account** - Permanently remove all data (use with caution)
+
+---
+
+## Keyboard Shortcuts
+
+### Command Palette
+
+The Command Palette is your productivity powerhouse, accessible from anywhere in the application.
+
+**Opening the Command Palette:**
+
+- Press **Ctrl+K** (or **Cmd+K** on Mac)
+- Or click the lightning bolt icon in the header
+
+**Using the Command Palette:**
+
+1. Type to search for any command
+2. Use ↑↓ arrow keys to navigate results
+3. Press Enter to execute selected command
+4. Press Escape to close without action
+
+**Available Commands:**
+
+**Navigation:**
+
+- "Go to Dashboard" - Jump to the Dashboard
+- "Open Projects" - Navigate to Projects page
+- "Browse Documents" - Open Documents library
+- "View Plugins" - Access Plugins marketplace
+- "View Profile" - Go to your Profile
+- "Open Settings" - Access Settings page
+
+**Theme:**
+
+- "Switch to Light Theme" - Enable light mode
+- "Switch to Dark Theme" - Enable dark mode
+
+**Smart Search:**
+
+- The command palette understands keywords
+- Try typing "dark", "home", "plugins", or "settings"
+- Results are filtered in real-time as you type
+
+**Why Use the Command Palette:**
+
+- Faster than clicking through menus
+- No need to remember exact locations
+- Works from any page in the app
+- Keyboard-first workflow for power users
+
+### Global Shortcuts
+
+- **Ctrl+K** (Cmd+K on Mac) - Open Command Palette
+- **Escape** - Close dialogs and modals
+
+### Search Page Shortcuts
+
+- **↑ Arrow Up** - Move to previous result
+- **↓ Arrow Down** - Move to next result
+- **Enter** - Open selected result
+
+### Session Workspaces
+
+- **Click logo 5 times quickly** - Open developer tools (easter egg)
+
+---
+
+## Tips & Best Practices
+
+### Session Management
+
+1. **Use Descriptive Names** - Name sessions by project, date, or topic for easy identification
+2. **One Topic Per Session** - Group related documents together for better organization
+3. **Save Frequently** - Click "Save and Close" regularly to preserve your work
+4. **Check Tracked Changes** - Always review the Tracked Changes tab before finalizing
+
+### Doc Processing
+
+1. **Test With One Document First** - Before batch processing, test settings on a single document
+2. **Enable Relevant Options Only** - Don't enable operations you don't need - faster processing
+3. **Use Replacements Wisely** - Be specific with find/replace rules to avoid unintended changes
+4. **Review Error Messages** - If processing fails, read the error carefully for guidance
+5. **Keep Backups** - Original files are preserved, but export important sessions just in case
+
+### Performance Optimization
+
+1. **Use Compact/Minimal Density** - Reduces visual overhead on slower systems
+2. **Disable Animations** - Turn off animations in Settings > Appearance for better performance
+3. **Disable Visual Effects** - Turn off glass morphism if you experience lag
+4. **Process in Smaller Batches** - Instead of 50 documents at once, do 10-15 at a time
+
+### Organization
+
+1. **Use Analytics** - Regularly check Analytics to understand your productivity patterns
+2. **Use Search** - Don't manually browse - search is faster and more accurate
+3. **Close Inactive Sessions** - Keep your sidebar clean by closing sessions you're not actively using
+4. **Export Data Regularly** - Use Settings > Storage > Export to create backups
+
+### Customization
+
+1. **Start With Presets** - Use typography presets before manual adjustments
+2. **Match Your Environment** - Light theme for bright rooms, Dark theme for low light
+3. **Choose Comfortable Density** - Don't sacrifice comfort for compactness
+4. **Test Custom Colors** - Make sure custom colors have good contrast (auto-detected for text)
+
+### Getting Help
+
+1. **Check Page Descriptions** - The gray text under each page title explains what it does
+2. **Hover for Tooltips** - Many buttons show helpful tooltips on hover
+3. **Use Submit Idea** - Share feedback and suggestions through Settings
+4. **Check for Updates** - New versions include bug fixes and improvements
+
+---
+
+## Troubleshooting Common Issues
+
+### Documents Won't Upload
+
+- Ensure files are .docx format (not .doc or other formats)
+- Check file permissions - you need read access
+- Try selecting files instead of drag-and-drop
+
+### Processing Fails
+
+- Review the error message in the document list
+- Try processing with fewer operations enabled
+- Ensure you have write permissions to the output location
+- Check that the document isn't corrupted
+
+### Application Performance Issues
+
+- Disable animations in Settings > Appearance
+- Disable glass morphism effects
+- Use Compact or Minimal density mode
+- Close unnecessary sessions
+- Clear cache in Settings > Storage
+
+### Can't Find a Document
+
+- Use the Search page with filters
+- Check the correct session is selected
+- Verify the status filter isn't hiding it
+- Check Recent Sessions on the Dashboard
+
+### Theme/Colors Look Wrong
+
+- Reset to defaults using typography presets
+- Disable custom colors in Appearance settings
+- Try switching between Light and Dark themes
+- Check your operating system's color settings
+
+### Updates Won't Install
+
+- Check your internet connection
+- Try manual download if auto-update fails
+- Ensure you have write permissions to the app folder
+- Temporarily disable antivirus if it's blocking the installer
+
+---
+
+## Conclusion
+
+Documentation Hub is designed to streamline your document processing workflow with powerful automation, intuitive organization, and extensive customization. This guide covers all major features, but don't hesitate to explore and experiment - the application is designed to be forgiving and all changes are reversible.
+
+**Remember:**
+
+- Sessions organize your work
+- Processing options give you control
+- Analytics show your impact
+- Customization makes it yours
+
+Happy document processing!
+
+---
+
+## How Settings Link to Document Processing
+
+Understanding how your UI settings flow to the document processing pipeline helps you achieve consistent, predictable results.
+
+### Style Settings → Document Formatting
+
+The paragraph styles you configure in the **Styles Editor** tab directly control how your documents are formatted:
+
+| Style Setting | Affects |
+|---------------|---------|
+| **Normal** style | Body text, table cell content, non-heading paragraphs |
+| **Heading 1-6** styles | Heading paragraphs matching each level |
+| Font family/size | Applied to matching paragraphs and table cells |
+| Bold/Italic/Underline | Applied to runs within matching paragraphs |
+| Alignment | Paragraph alignment (left, center, right, justify) |
+| Spacing Before/After | Space above and below paragraphs |
+| Line Spacing | Space between lines within paragraphs |
+
+**Preserve Options**: The "Lock Bold", "Lock Italic", "Lock Underline", and "Lock Center" buttons in the Styles Editor prevent the processor from overriding existing formatting in your documents. For example, if "Lock Center" is enabled for Normal style, centered text stays centered instead of being changed to the Normal style's alignment.
+
+### Table Shading Settings → Table Formatting
+
+The **Table & Image Settings** section controls how tables are formatted:
+
+| Setting | Effect |
+|---------|--------|
+| **Header2 Shading Color** | Background color for cells in tables under Heading 2 sections |
+| **Other Shading Color** | Background color for shaded cells in other tables |
+| **Image Border Width** | Border thickness (in points) applied around large images |
+
+**Important Table Behavior**:
+- Tables larger than 1x1: Shaded cells are always bold and centered, regardless of style settings
+- Table cell text formatting: Inherits font family/size from the **Normal** paragraph style
+- Table cell spacing: Uses spacing settings from the **Normal** paragraph style
+- Header rows (first row): Always bold and centered for emphasis
+
+### List Bullet Settings → List Formatting
+
+The **List Bullets** section controls numbered and bulleted list formatting:
+
+| Setting | Effect |
+|---------|--------|
+| **Enable List Formatting** | Master toggle for list processing |
+| **Indentation Levels (1-5)** | Symbol indent, text indent, and bullet character per level |
+| **Spacing Between Items** | Vertical space between list items |
+
+### Processing Options Flow
+
+When you click "Process Document", the options flow through this pipeline:
+
+```
+Session Settings (UI)
+       ↓
+SessionContext (state management)
+       ↓
+IPC Call to Main Process
+       ↓
+WordDocumentProcessor
+       ↓
+Individual Processors:
+├── StyleProcessor (paragraph styles)
+├── TableProcessor (table formatting)
+├── ListProcessor (list bullets)
+└── StructureProcessor (TOC, headers)
+       ↓
+DocXMLater Document API
+       ↓
+Processed .docx File
+```
+
+### Tips for Consistent Results
+
+1. **Configure Normal style first** - Many other elements inherit from Normal style
+2. **Test with one document** - Verify settings before batch processing
+3. **Use Lock options sparingly** - Only enable when you need to preserve specific formatting
+4. **Review Tracked Changes** - Check the Tracked Changes tab to see exactly what changed
+
+---
+
+_Last Updated: January 2026_
+_Documentation Hub Version: 5.0.4_