📖:Docs ( Update ) Document namespace manager caching and UI improvements

docs/content/console/console-features.md

@@ -107,7 +107,7 @@ The sidebar provides access to all major sections:
 ### Secondary Navigation
 
 - **Card History**: Previously viewed cards
-- **Namespaces**: Namespace-specific views
+- **Namespaces**: Namespace management across clusters - create, view, and manage namespaces with intelligent error handling and offline cluster detection
 - **User Management**: RBAC and access control
 - **Settings**: Console configuration
 
@@ -125,6 +125,36 @@ The global search bar (`Cmd/Ctrl + K`) enables quick navigation:
 - Navigate to specific namespaces
 - Filter by resource type
 
+## Namespace Management
+
+The Namespace Management page (`/namespaces`) provides a centralized interface for managing namespaces across all your clusters.
+
+### Key Features
+
+- **Direct Agent Access**: Namespace data is fetched directly from the KSC Agent, providing faster response times and bypassing potential backend authentication issues
+- **Smart Caching**: Intelligently caches namespace data while preventing empty states from being persisted on temporary failures
+- **Offline Cluster Handling**: Clearly identifies offline clusters in the header without redundant error messages
+- **Filtered Creation**: The Create Namespace dialog automatically filters out offline clusters, ensuring namespace creation only targets available clusters
+- **Intelligent Error Display**: Error banners only appear when ALL clusters fail to respond, not on partial failures
+
+### Creating Namespaces
+
+To create a new namespace:
+
+1. Navigate to `/namespaces`
+2. Click the "Create" button (sized appropriately for UI consistency)
+3. Select one or more online clusters from the dialog
+4. Enter the namespace name
+5. Confirm to create the namespace across selected clusters
+
+Note: The create dialog only displays clusters that are currently online and responsive, preventing failed creation attempts.
+
+### Cluster Status Indicators
+
+- **Online clusters**: Show namespace lists and are available for namespace creation
+- **Offline clusters**: Marked clearly in the header with offline status indicators
+- **Partial failures**: Do not trigger error banners; only complete failures across all clusters show errors
+
 ## Alerts
 
 The alert system keeps you informed:

docs/content/console/dashboards.md

@@ -301,6 +301,40 @@ Focus on pods:
 
 ---
 
+### Namespaces Dashboard
+
+**Route:** `/namespaces`
+
+Manage namespaces across all your clusters:
+- View all namespaces from online clusters
+- Create new namespaces on one or more clusters
+- See which clusters are online or offline
+- Real-time namespace discovery using the KSC Agent (local agent)
+
+**Best for:** Managing namespace access and organization
+
+#### Key Features
+
+- **Smart Error Handling**: Error banners only appear when ALL clusters fail to respond, not on partial failures
+- **Offline Cluster Detection**: Offline clusters are clearly marked in the header with status indicators
+- **Filtered Creation**: The Create Namespace dialog only shows online clusters, preventing failed creation attempts
+- **Improved Caching**: Namespace data is cached intelligently and won't persist empty states on temporary failures
+- **Direct Agent Access**: Fetches namespaces directly from the KSC Agent, bypassing backend authentication issues
+
+#### How to Use
+
+1. **View Namespaces**: The page automatically loads namespaces from all connected online clusters
+2. **Create a Namespace**:
+   - Click the "Create" button (only appears if at least one cluster is online)
+   - Select one or more online clusters from the dialog
+   - Enter the namespace name
+   - Confirm to create across selected clusters
+3. **Monitor Status**:
+   - Check cluster headers for online/offline status
+   - Watch for error banners if all clusters become unavailable
+
+---
+
 ## Utility Pages
 
 These aren't counted as dashboards but are useful:
@@ -312,6 +346,7 @@ These aren't counted as dashboards but are useful:
 | User Management | `/users` | Manage users (admin only) |
 | Namespaces | `/namespaces` | Manage namespace access |
 
+
 ---
 
 ## Tips