Skip to content

docs(ia): add For Developers landing page and category link#1283

Open
ekline[bot] wants to merge 1 commit into
mainfrom
docs/ia/add-for-developers-landing
Open

docs(ia): add For Developers landing page and category link#1283
ekline[bot] wants to merge 1 commit into
mainfrom
docs/ia/add-for-developers-landing

Conversation

@ekline

@ekline ekline Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Persona context

Reviewed the Okteto docs from the Developer persona: an engineer whose platform team has already set up Okteto, who wants to deploy a Development Environment and get okteto up running against the cluster. Entry point: sidebar → Get Started → For Developers.

Top findings (high/medium)

Rank Priority Persona Issue Affected area Proposed fix
1 High Developer The "For Developers" category — the primary developer entry point — has no landing/index page (the only major grouping without one). Expanding it drops the developer onto three sequentially-dependent pages with non-parallel labels and no orientation on reading order. docs/sidebars.js, get-started/ Add a For Developers overview page and wire it as the category link.
2 Medium Platform Admin / Operator Installation is split across three top-level areas (Get Started → Install Okteto Platform, Okteto BYOC, Okteto Self-Hosted) with no single orientation on which path to choose. get-started/install/, byoc/, self-hosted/ Cross-link the three install areas from one deployment-model chooser; surface saas-vs-self-hosted at the decision point.
3 Medium Okteto AI evaluator okteto-ai/index is listed twice in sidebars.js (once as the category link, once as the first items entry), producing a duplicate nav entry. docs/sidebars.js Remove the duplicate okteto-ai/index item.

What this PR fixes

Implements finding #1. Adds docs/src/content/get-started/for-developers.mdx, a concise overview that states what developing on Okteto does, then orients the reader through the three pages in order (Quickstart -> Using the CLI and Dashboard -> Advanced commands and concepts) with an inline pointer to installing the Okteto CLI. Wires it as the link for the "For Developers" category in docs/sidebars.js, matching the index-page pattern every other section uses. Existing content is untouched.

Remaining items (follow-up)

How to verify

  1. Run yarn build in docs/ to validate links and anchors.
  2. Run yarn start, open the sidebar, and click Get Started -> For Developers: the category now opens an overview page instead of only expanding.
  3. From the Developer persona's view, confirm the overview links forward to Quickstart, the CLI and Dashboard guide, and Advanced commands and concepts, plus the CLI install page.

Note: yarn build was not run in the authoring environment (no node_modules, network-sandboxed). The new page follows the repo's proven link and id conventions (mirrors get-started/dev-quickstart).


📝 Created with EkLine · View session

Add an overview page for the Get Started > For Developers category and
wire it as the category link, so developers land on an orientation page
that sequences Quickstart, the CLI and Dashboard guide, and Advanced
commands and concepts instead of expanding into three unlabeled pages.

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

Signed-off-by: ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>
@netlify

netlify Bot commented Jul 1, 2026

Copy link
Copy Markdown

Deploy Preview for okteto-docs ready!

Name Link
🔨 Latest commit 1c9bf01
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/6a4557e4279ea100084a71e8
😎 Deploy Preview https://deploy-preview-1283--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