docs(cli): enhance help output with features and examples

Updates the `lv --help` documentation to be more comprehensive and professional.
Key changes:
- Expanded project description to highlight performance capabilities.
- Added a detailed list of key features (Virtualization, Time Travel, Filtering).
- Added practical usage examples for files, Docker, and Kubernetes pipes.

Author: RajeshkannanRamakrishnan

cmd/root.go

@@ -13,8 +13,24 @@ import (
 
 var rootCmd = &cobra.Command{
 	Use:   "lv [file]",
-	Short: "Log Viewer is a TUI for viewing log files",
-	Long:  `A fast and interactive Log Viewer built with Bubbletea.`,
+	Short: "High-performance TUI for log analysis",
+	Long: `lv is a blazing fast terminal-based log viewer designed for developers and DevOps.
+
+Key Features:
+  - Instant loading of large files (GB+) via virtualization.
+  - Interactive filtering (fuzzy & regex) and time-range drill-down.
+  - "Time Travel": Jump directly to a specific timestamp (press 'J').
+  - Stack trace folding for cleaner error analysis.
+  - Follow mode (tail -f) with auto-scroll.
+  - Mouse support for scrolling and selection.
+  - Rich keyboard shortcuts (vim-like navigation).`,
+    Example: `  # Open a local file
+  lv app.log
+
+  # Pipe logs from stdin
+  kubectl logs -f my-pod | lv
+  docker logs my-container | lv
+  cat large.log | lv`,
 	Args:  cobra.MaximumNArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		var lines []string

internal/ui/model.go

@@ -1225,36 +1225,77 @@ func max(a, b int) int {
 }
 
 func (m Model) helpView() string {
-	helpRequest := []struct {
-		key, desc string
-	}{
-		{"?", "Toggle Help"},
-		{"q / esc", "Quit / Close Help"},
-		{"/", "Filter Logs"},
-		{"f", "Toggle Follow"},
-		{"j / k", "Scroll Down / Up"},
-		{"g / G", "Scroll Top / Bottom"},
-        {"m", "Toggle Bookmark"},
+    // Define helper struct for keys
+    type helpEntry struct {
+        key, desc string
+    }
+    
+    // Group keys
+    general := []helpEntry{
+        {"?", "Close Help"},
+        {"q / esc", "Quit / Close"},
+        {"ctrl+c", "Quit"},
+    }
+    
+    nav := []helpEntry{
+        {"j / k", "Scroll Down / Up"},
+        {"g / G", "Scroll Top / Bottom"},
+        {"f", "Toggle Follow"},
         {"J", "Jump to Time"},
+        {"space", "Page Down"},
+        {"b / u", "PgUp / PgDown"},
+    }
+    
+    filtering := []helpEntry{
+        {"/", "Filter Logs"},
+        {"c", "Clear Filters"},
+        {"R", "Regex Toggle"},
+        {"s / e", "Set Start / End (Time)"},
+        {"1-4", "Toggle Levels (Err/Warn...)"},
+    }
+    
+    viewing := []helpEntry{
+        {"w", "Toggle Wrap"},
+        {"z", "Fold Stack Traces"},
         {"t", "Toggle Timeline"},
+        {"m", "Toggle Bookmark"},
+        {"l / h", "Scroll Right / Left"},
         {"r", "Reload File"},
-        {"c", "Clear Filters"},
-	}
-
-	s := lipgloss.NewStyle().
-		Border(lipgloss.RoundedBorder()).
-		BorderForeground(lipgloss.Color("62")).
-		Padding(1, 2)
-
-	var b strings.Builder
-	b.WriteString(lipgloss.NewStyle().Bold(true).Render("Keyboard Shortcuts"))
-	b.WriteString("\n\n")
+    }
 
-	for _, h := range helpRequest {
-		key := lipgloss.NewStyle().Foreground(lipgloss.Color("205")).Width(12).Render(h.key)
-		desc := lipgloss.NewStyle().Foreground(lipgloss.Color("240")).Render(h.desc)
-		b.WriteString(fmt.Sprintf("%s %s\n", key, desc))
-	}
+	// Styles
+    boxStyle := lipgloss.NewStyle().
+        Border(lipgloss.RoundedBorder()).
+        BorderForeground(lipgloss.Color("62")).
+        Padding(1, 2).
+        Margin(1)
+        
+    headerStyle := lipgloss.NewStyle().
+        Foreground(lipgloss.Color("240")).
+        Bold(true).
+        Underline(true).
+        MarginBottom(1)
+        
+    keyStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("205"))
+    descStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("252"))
+
+    // Helper to render a column
+    renderColumn := func(title string, entries []helpEntry) string {
+        s := headerStyle.Render(title) + "\n"
+        for _, e := range entries {
+            k := keyStyle.Width(10).Render(e.key)
+            d := descStyle.Render(e.desc)
+            s += fmt.Sprintf("%s %s\n", k, d)
+        }
+        return s
+    }
+    
+    // Layout
+    col1 := renderColumn("General", general) + "\n" + renderColumn("Navigation", nav)
+    col2 := renderColumn("Filtering", filtering) + "\n" + renderColumn("View & Tools", viewing)
+    
+    // Join columns with gap
+    content := lipgloss.JoinHorizontal(lipgloss.Top, col1, "    ", col2)
 
-	return s.Render(b.String())
+	return boxStyle.Render(content)
 }