📖:Docs ( Update ) Document namespace manager caching and UI improvements#1025
📖:Docs ( Update ) Document namespace manager caching and UI improvements#1025gulshank0 wants to merge 6 commits intokubestellar:mainfrom
Conversation
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
✅ Deploy Preview for kubestellar-docs ready!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
Hi @gulshank0. Thanks for your PR. I'm waiting for a kubestellar member to verify that this patch is reasonable to test. If it is, they should reply with Once the patch is verified, the new status will be reflected by the I understand the commands that are listed here. DetailsInstructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. |
|
Welcome to KubeStellar! 🚀 Thank you for submitting this Pull Request. Before your PR can be merged, please ensure: ✅ DCO Sign-off - All commits must be signed off with ✅ PR Title - Must start with an emoji: ✨ (feature), 🐛 (bug fix), 📖 (docs), 🌱 (infra/tests), Getting Started with KubeStellar: Contributor Resources:
🌟 Help KubeStellar Grow - We Need Adopters! Our roadmap is driven entirely by adopter feedback. Whether you're using KubeStellar yourself or know someone who could benefit from multi-cluster Kubernetes: 📋 Take our Multi-Cluster Survey - Share your use cases and help shape our direction! A maintainer will review your PR soon. Feel free to ask questions in the comments or on Slack! |
There was a problem hiding this comment.
Pull request overview
Updates the Console documentation to reflect recent namespace manager caching behavior and UI improvements related to namespace discovery, error handling, and offline cluster handling.
Changes:
- Added a new “Namespaces Dashboard” section to the dashboards documentation (route, features, and usage).
- Expanded the Console Features documentation with a new “Namespace Management” section and updated the sidebar navigation description for Namespaces.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| docs/content/console/dashboards.md | Adds a dedicated Namespaces dashboard section (route, key features, how-to). |
| docs/content/console/console-features.md | Updates navigation text for Namespaces and documents namespace management behavior/features. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Namespaces Dashboard | ||
|
|
||
| **Route:** `/namespaces` | ||
|
|
||
| Manage namespaces across all your clusters: |
There was a problem hiding this comment.
The new “Namespaces Dashboard” section conflicts with the later “Utility Pages” section, which states those pages “aren’t counted as dashboards” but still lists “Namespaces” as a utility page. Please reconcile this by either removing/updating the Utility Pages entry for /namespaces or adjusting the Utility Pages description so the classification is consistent.
docs/content/console/dashboards.md
Outdated
| - Real-time namespace discovery using 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 local agent, bypassing backend authentication issues |
There was a problem hiding this comment.
This section refers to a “local agent”, but elsewhere the docs introduce this component as the “KSC Agent” (e.g., docs/content/console/console-overview.md). For consistency and clarity, consider using the established term (and optionally mention it’s the local agent once).
…rovements Signed-off-by: gulshank0 <gulshanbahadur002@gmail.com>
KSC Agent added Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: gulshank0 <gulshanbahadur002@gmail.com>
format updating Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: gulshank0 <gulshanbahadur002@gmail.com>
Signed-off-by: gulshank0 <gulshanbahadur002@gmail.com>
Signed-off-by: gulshank0 <gulshanbahadur002@gmail.com>
📌 Fixes : #1024
Closes #1024
📝 Summary of Changes
Updated the Docs on Two diffrent palces :
Changes Made
Checklist
Please ensure the following before submitting your PR:
👀 Reviewer Notes
Add any special notes for the reviewer here