Skip to content

docs: add tutorials for Okteto Test, Okteto AI, and Agentic Workflows#1208

Open
ekline[bot] wants to merge 1 commit into
mainfrom
tutorials/add-test-ai-agentic-tutorials
Open

docs: add tutorials for Okteto Test, Okteto AI, and Agentic Workflows#1208
ekline[bot] wants to merge 1 commit into
mainfrom
tutorials/add-test-ai-agentic-tutorials

Conversation

@ekline
Copy link
Copy Markdown
Contributor

@ekline ekline Bot commented Apr 20, 2026

Summary

Addresses three high-priority tutorial gaps from the April 2026 tutorial gap review:

  • Okteto Test tutorial (src/tutorials/okteto-test.mdx): End-to-end guide for running unit, API, and e2e tests using Test Containers with the Movies sample app. Covers test configuration in okteto.yaml, caches, artifacts, and adding custom test containers.
  • Okteto AI tutorial (src/tutorials/okteto-ai-first-agent.mdx): Walks through launching a first AI agent from the Dashboard — choosing a repo, writing effective prompts, monitoring the agent, reviewing output in the preview environment, and creating a PR.
  • Agentic Workflows tutorial (src/tutorials/agentic-workflows.mdx): Installs the Claude Code plugin and demonstrates both collaborative mode (developer runs okteto up, agent uses okteto exec) and autonomous mode (agent handles the full deploy-test-PR lifecycle).

Updates sidebarTutorials.js to include the three new tutorials.

Gap review context

Gap # Priority Tutorial Status
2 High Agentic Workflows end-to-end tutorial Fixed in this PR
3 High Okteto Test workflow tutorial Fixed in this PR
4 High Okteto AI getting-started tutorial Fixed in this PR

Remaining follow-ups

  • Gap 1 (High): Preview Environments end-to-end tutorial
  • Gap 5 (Medium): Catalog-based onboarding tutorial
  • Gaps 6-8 (Medium): Namespaces, Manifest deep-dive, Hybrid mode tutorials

Test plan

  • Run yarn start and verify all three tutorials render correctly in the sidebar under Tutorials
  • Click through all internal links in each tutorial to confirm they resolve
  • Run yarn build to validate no broken links or anchors
  • Review tutorial content for technical accuracy against current CLI behavior

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

Addresses three high-priority tutorial gaps identified in the April 2026
tutorial gap review:

- Okteto Test tutorial: end-to-end guide for running unit, API, and e2e
  tests using Test Containers with the Movies sample app
- Okteto AI tutorial: launching a first AI agent from the Dashboard,
  writing effective prompts, and creating a pull request
- Agentic Workflows tutorial: installing the Claude Code plugin and
  using collaborative and autonomous modes with Okteto environments

Updates sidebarTutorials.js to include the three new tutorials.

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

netlify Bot commented Apr 20, 2026

Deploy Preview for okteto-docs failed. Why did it fail? →

Name Link
🔨 Latest commit bd58da2
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/69e643e8fd4cff00083b4c5d

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