Skip to content

docs: make Kest docs workspace-first - #110

Merged
canadaell merged 5 commits into
mainfrom
feature/kest-cli-docs
Jun 7, 2026
Merged

docs: make Kest docs workspace-first#110
canadaell merged 5 commits into
mainfrom
feature/kest-cli-docs

Conversation

@canadaell

Copy link
Copy Markdown
Contributor

Summary

  • Added docs deployment workflow with Mintlify validation and guarded deploy trigger.
  • Added missing CI, Flow Authoring, Assertions & Variables, Local Bridge, and Troubleshooting docs in English and Chinese.
  • Cleaned existing MDX guides to use workspace-first terminology and Kest Cloud Sync wording.
  • Renamed the collaboration guide from project to workspace and updated navigation.
  • Regenerated the OpenAPI/API Reference as workspace-first, including workspace CLI token schemas and /v1/workspaces routes.

Notes

  • The old /workflows/project-collaboration docs URL was renamed to /workflows/workspace-collaboration. No redirect file was added because repo-level Mintlify redirects were not verified here.
  • docs.kest.dev deployment still depends on the Mintlify dashboard repo/root/branch configuration and GitHub secrets MINTLIFY_API_KEY and MINTLIFY_PROJECT_ID.

Validation

  • node scripts/check-workspace-terminology.mjs
  • git diff --check
  • node docs-site/scripts/generate-openapi.mjs
  • rg -n "Project|Projects|/v1/projects|project-scoped|platform_project_id" docs-site
  • node -e "JSON.parse(require('fs').readFileSync('docs-site/docs.json','utf8'))"
  • cd docs-site && mint validate

@vercel

vercel Bot commented Jun 7, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
kest Ready Ready Preview, Comment Jun 7, 2026 6:53pm

Request Review

@canadaell
canadaell merged commit bf73f65 into main Jun 7, 2026
4 checks passed
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