Skip to content

docs(ui-accuracy): align admin sidebar labels and navigation paths with frontend#1243

Open
ekline[bot] wants to merge 1 commit into
mainfrom
docs/ui-accuracy/align-admin-nav-labels
Open

docs(ui-accuracy): align admin sidebar labels and navigation paths with frontend#1243
ekline[bot] wants to merge 1 commit into
mainfrom
docs/ui-accuracy/align-admin-nav-labels

Conversation

@ekline
Copy link
Copy Markdown
Contributor

@ekline ekline Bot commented May 12, 2026

Context

This PR fixes factual mismatches between documentation and the frontend UI, verified against the current component code in app/frontend/src/. Cosmetic and stylistic changes are intentionally out of scope.

Scan summary

  • Files scanned: 50+ documentation files across admin/, get-started/, core/, development/, previews/, reference/, okteto-ai/, and agentic/ directories
  • Files with High or Medium findings: 3
  • Files fixed this run: 3
  • Files deferred: 0

Fixes

File What the doc said What the frontend shows Fix
src/content/admin/dashboard.mdx Settings section lists SSH Known Hosts as 3rd item Sidebar label is Known Hosts, listed last in Settings group (ClusterView.tsx) Renamed to Known Hosts and reordered to match frontend sidebar
src/content/admin/dashboard.mdx Integrations section lists General Integrations Sidebar label is General (ClusterView.tsx) Changed listing text to General
src/content/admin/cloud-credentials/gcp.mdx OIDC endpoint under the Integrations -> Cloud Credentials section OIDC is rendered on the General integrations page (AdminIntegrations.tsx:63) Changed to Integrations -> General
src/content/admin/integrations/okta-user-deprovisioning.mdx Navigate to Admin -> Integrations -> Okta Deprovisioning No Okta Deprovisioning sidebar item exists; Okta config is a section within the General page (AdminIntegrations.tsx:65) Changed to Admin -> General under Integrations section

Frontend files referenced

  • app/frontend/src/views/AppView/ClusterView.tsx — Admin sidebar group names and item labels
  • app/frontend/src/features/AdminIntegrations/AdminIntegrations.tsx — General integrations page rendering OIDC and Okta sections

Test plan

  • Verify yarn build passes with no broken links or anchors
  • Check the Admin Dashboard sidebar in the product matches the documented order and labels
  • Confirm the GCP cloud credentials page correctly directs to Admin -> General for the OIDC endpoint
  • Confirm the Okta deprovisioning page correctly directs to Admin -> General under Integrations

ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>

Fix factual mismatches between docs and the Okteto frontend UI:
- Rename "SSH Known Hosts" to "Known Hosts" to match sidebar label
- Reorder Settings section items to match ClusterView.tsx sidebar
- Change "General Integrations" listing to "General" to match sidebar
- Fix GCP OIDC navigation from "Cloud Credentials" to "General"
- Fix Okta deprovisioning navigation from nonexistent sidebar item
  to "Admin → General" under Integrations

ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented May 12, 2026

Deploy Preview for okteto-docs ready!

Name Link
🔨 Latest commit 5bb1356
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/6a037c8f04d3980008e8cfa1
😎 Deploy Preview https://deploy-preview-1243--okteto-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants