docs(ia): rewrite Core Concepts landing page for inline navigation#1241
Open
ekline[bot] wants to merge 1 commit into
Open
docs(ia): rewrite Core Concepts landing page for inline navigation#1241ekline[bot] wants to merge 1 commit into
ekline[bot] wants to merge 1 commit into
Conversation
Replace banned preamble ("Before you start building with Okteto...") and
10 standalone "Learn more →" links with inline descriptive sentences.
All three personas (developer, platform engineer, AI practitioner) pass
through this hub page — the rewrite makes every concept scannable and
linkable in flowing text.
Signed-off-by: ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>
ekline
Bot
requested review from
codyjlandstrom,
ifbyol,
pchico83 and
rlamana
as code owners
✅ Deploy Preview for okteto-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A persona-scoped IA review identified the Core Concepts landing page (
src/content/core/index.mdx) as the highest-impact fix across all three user personas (developer, platform engineer, AI/agent practitioner). Every persona passes through this page to understand Okteto's building blocks.Issues fixed:
descriptionto be a single functional sentence (not marketing copy)Persona context
Top 3 IA findings from persona review
core/index.mdxadmin/index.mdxWhat this PR fixes
Finding #1: the Core Concepts landing page. The rewrite:
Remaining items
npm link#2 Admin landing page (admin/index.mdx): needs the same treatment — remove "robust tools", "comprehensive overview", "Administering Like a Pro", and "Learn more →" patternsHow to verify
yarn buildto validate no broken linksekline[bot] <202747777+ekline[bot]@users.noreply.github.com>