Skip to content

docs: prepare DAP kits and launcher guidance - #26142

Draft
dvdksn wants to merge 7 commits into
docker:mainfrom
dvdksn:codex/dap-kits-gui-docs
Draft

dvdksn wants to merge 7 commits into
docker:mainfrom
dvdksn:codex/dap-kits-gui-docs

Conversation

@dvdksn

@dvdksn dvdksn commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

The hidden DAP docs describe a fixed set of sandbox types and omit the public-kit workflow. Add a Kits page and update the launcher, credentials, sandbox, MCP, policy, and FAQ guidance for the anticipated GUI release.

CLI and v3 kit documentation are out of scope (to come later).

Validated with scoped rumdl/Vale lint, a Hugo build, and checks for internal links, kit redirects, and hidden-page discovery behavior.

@netlify /agentic-platform/kits/

Generated by Codex

The hidden DAP docs described a fixed set of sandbox types and omitted public kit discovery and launch workflows. Add a Kits page, update sandbox and credential guidance for the anticipated GUI release, and record the changes under Unreleased while preserving hidden discovery settings.

The agent prompt and launcher instructions anticipate docker/agentic-platform PRs docker#4376, docker#4377, and docker#4378. CLI usage and kit schema documentation remain outside this change.
@netlify

netlify Bot commented Sep 21, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit bb3eb24
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ab124668c8b280008736e79
😎 Deploy Preview https://deploy-preview-26142--docsdocker.netlify.app/agentic-platform/kits/
📱 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.

The overview gave kit definitions and catalog options too much space. Keep a single linked mention and leave the detailed explanation on the Kits page.
Replace infrastructure narration and abstract phrasing with direct explanations of sandbox tasks and behavior. Preserve credential handling, network policy rules, billing details, and existing links.
The launch instructions mixed saved credential behavior with GitHub setup without explaining what users needed to do. Explain that saved keys need no repeat entry or selection, give GitHub its own step, and align the Secrets page and release notes.
The GitHub setup step led with a conditional UI detail instead of explaining why authentication is needed. Lead with repository access and Copilot, explain where to save the token, and link to the credential details.
Copilot requests its GitHub token as the agent credential, so directing all users to a separate repository-access control was misleading. Cover Copilot in the credential step and make repository authentication optional for other kits, with matching Secrets guidance.
Keep the agent credential step generic. Explain in the optional repository-access step that Copilot reuses its agent token, and align the Secrets documentation with that distinction.
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.

1 participant