Skip to content

docs(seo): align Development Environments title and description with primary keywords#1245

Open
ekline[bot] wants to merge 1 commit into
mainfrom
docs/seo/align-dev-env-title-keywords
Open

docs(seo): align Development Environments title and description with primary keywords#1245
ekline[bot] wants to merge 1 commit into
mainfrom
docs/seo/align-dev-env-title-keywords

Conversation

@ekline
Copy link
Copy Markdown
Contributor

@ekline ekline Bot commented May 13, 2026

Context

This PR addresses an SEO issue identified by auditing the documentation against Okteto's keyword strategy from the marketing website.

The Development Environments landing page (development/index.mdx) is the primary page for the #1 target keyword Kubernetes development environments, but its title and meta description did not include "Kubernetes" at all. The description also used the banned "In this section, we'll see" preamble pattern.

Keyword map

Primary keywords (from okteto.com marketing site):

  • Kubernetes development environments
  • Cloud development environments
  • Preview environments
  • Development platform Kubernetes

Secondary keywords:

  • Okteto Manifest, Okteto CLI, file sync Kubernetes, development containers

Top 3 SEO findings

Rank Priority Page Issue Status
1 High development/index.mdx Title missing "Kubernetes" keyword; description uses banned pattern and is too short (79 chars) Fixed in this PR
2 High self-hosted/index.mdx Title (18 chars) and description (35 chars) extremely thin, missing "Kubernetes platform" keyword Follow-up
3 Medium 20+ files Heading hierarchy violations (H1 to H3 jumps) Follow-up

What this PR fixes

  • Title: "Development Environments" (24 chars) → "Development Environments on Kubernetes" (37 chars)
  • Description: Rewrote from banned preamble (79 chars) to a functional sentence with primary keywords (136 chars)
  • Body: Removed marketing language ("joyful development experience", "cool features"), fixed list to use parallel noun-phrase structure, removed emoji and banned preamble

How to verify

  1. Run yarn build in docs/ to confirm no broken links
  2. Check that the updated frontmatter renders correctly in the Docusaurus dev server (yarn start)
  3. Verify the page title and meta description in the HTML source

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

…primary keywords

The Development Environments landing page is the primary page for the
Kubernetes development environments search term, but its title and
meta description did not include Kubernetes. The description also used
the banned In this section preamble pattern.

- Title: Development Environments to Development Environments on Kubernetes
- Description: rewrote as a functional 136-char sentence with primary keywords
- Body: removed marketing language, fixed list to use parallel noun phrases

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

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

netlify Bot commented May 13, 2026

Deploy Preview for okteto-docs ready!

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