[swkeever]

Why

Kong/volcano-docs becomes the single source of truth for all public Volcano docs. The daily cross-repo sync that copied this repo's docs/ into volcano-docs content/cli is being removed, so this repository stops carrying published docs. Agents and contributors now write CLI docs directly in volcano-docs with a companion PR.

What changed

• Remove docs/ (27 pages). volcano-docs content/cli owns the published copy.
• Remove .github/workflows/lint-docs.yml, which only ran the volcano-docs reusable lint on docs/**. It is not a required check.
• AGENTS.md: replace the "update docs/ in the same PR" rule with: public CLI docs live in Kong/volcano-docs under content/cli; a user-facing change opens a companion PR there. The guidance to keep maintainer material next to the code stays.
• README.md and CONTRIBUTING.md: point doc links at https://docs.volcano.dev/cli. The README's "CLI operations overview" link (docs/cli/overview.md) is dropped because that page never existed.
• internal/docs/source.go: comment now says the CLI docs live (not are synced) under content/cli. No behavior change: volcano docs already reads Kong/volcano-docs content/ at runtime.

No test in this repo reads docs/, and nothing generates docs/ from code.

docs/ vs volcano-docs content/cli

Every CLI docs change is now in volcano-docs content/cli:

• feat(docs): author all docs here and stop syncing from product repos volcano-docs#170 (merged) took a final snapshot of docs/ at 19e81be. It includes the changes from feat(cli): add --project to every volcano cloud command #474, feat(functions): deploy TypeScript function handlers #428, feat(functions): deploy .tsx function handlers #482, feat(lavaflow): remove the custom context and system prompt flags #481, feat(lavaflow): show the source of a run's issue #480 and feat(databases): apply migrations in tracked runs #365 (databases.md, deploy.md).
• docs(cli): port the git migrations toggle from volcano-cli volcano-docs#175 (merged) ports feat(git): turn applying database migrations on push on or off #490 (git.md), which landed after that snapshot.
• docs/ at main (65b50e7) now matches volcano-docs content/cli, with README.md as index.md.

Merge order

Kong/volcano-docs#170, which removes the sync, has merged, so this can merge now. A docs/ change that lands on main before this PR merges must be ported to volcano-docs first.

Testing

• go build ./...: passed
• go test ./...: passed
• go tool golangci-lint run ./internal/docs/...: 0 issues
• Checked the new links resolve on https://docs.volcano.dev (/cli, /cli/installation, /cli/authentication, /cli/deploy, /cli/project-configuration, /cli/docs-search return 200; an unknown path returns 404).

Related

• docs: move published docs to volcano-docs #489
• docs(guides): move published docs to volcano-docs volcano-sdk-js#367
• docs: move published docs to volcano-docs volcano-sdk-python#426
• docs: move published docs to volcano-docs volcano-sdk-ruby#373

🤖 Generated with Claude Code

[github-actions]

AI review: no P0-P2 findings

Reviewed 5b4d02b. Run log

This PR deletes the published docs/ tree (27 pages) and lint-docs.yml, which only linted docs/**. It points the README and CONTRIBUTING doc links at docs.volcano.dev/cli, replaces the AGENTS.md rule to update docs/ with a rule to open a companion PR in Kong/volcano-docs, and rewords one comment in internal/docs/source.go. No Go code, embed, workflow, script, release config, or package manifest in the head reads docs/, and volcano docs already fetches Kong/volcano-docs at runtime. The last review's finding was that #365 and #490 were missing from the list of pages to port. The description now covers both (volcano-docs#170 and #175), so that finding no longer applies. The remaining risk is the hand-off to volcano-docs, which this review can't check.

Not checked: The AI review read the diff, the code, and the PR's text; it ran no tests or builds and read nothing outside this repository.

• Whether Kong/volcano-docs has actually removed its daily sync from this repo's docs/, so that deleting docs/ doesn't remove or break the published CLI pages.
• Whether volcano-docs content/cli matches docs/ at this base (401569d), including the feat(databases): apply migrations in tracked runs #365 and feat(git): turn applying database migrations on push on or off #490 changes the description says volcano-docs#170 and feat(functions): configure RPC and HTTP invocation modes #175 carry.
• Whether the new docs.volcano.dev/cli links in README.md and CONTRIBUTING.md resolve on the live site.
• Verify Kong/volcano-docs preserves all 27 deleted pages, including the feat(databases): apply migrations in tracked runs #365 and feat(git): turn applying database migrations on push on or off #490 updates, and has removed the daily sync.
• Verify the new docs.volcano.dev/cli links resolve to the intended published pages.

Human review: not needed

[Copilot]

🔵 Needs a closer look

Deleting docs/ requires maintainer coordination to first merge the still-open Kong/volcano-docs#170 with sync removal and a final snapshot preserving the five unsynced CLI pages.

No open issues 🎉

What changed in this PR

Makes Kong/volcano-docs the sole source for public CLI documentation, removing the local published copies without changing CLI runtime behavior.

Changes:

• Removes 27 documentation pages and their lint workflow.
• Updates contributor guidance to require linked companion documentation PRs and points README links to the published site.
• Clarifies the documentation-source comment; volcano docs continues reading the same remote source.

The migration is coordinated with upstream sync removal and preservation of the five unsynced documentation updates identified in the PR description.

File	Description
README.md	Links to published CLI docs; drops a nonexistent page link.
internal/​docs/​source.go	Updates a source-location comment only.
docs/​variables.md	Removes local variables guide.
docs/​telemetry.md	Removes local telemetry guide.
docs/​storage.md	Removes local storage guide.
docs/​share.md	Removes local sharing and forking guide.
docs/​setup.md	Removes local agent setup guide.
docs/​scripting.md	Removes local scripting guide.
docs/​sandboxes.md	Removes local sandbox guide.
docs/​README.md	Removes local CLI overview.
docs/​project-configuration.md	Removes local configuration reference.
docs/​notifications.md	Removes local notifications guide.
docs/​logs.md	Removes local logs guide.
docs/​lavaflow.md	Removes local LavaFlow guide.
docs/​installation.md	Removes local installation guide.
docs/​git.md	Removes local Git connection guide.
docs/​functions.md	Removes local functions guide.
docs/​frontends.md	Removes local frontends guide.
docs/​feedback.md	Removes local feedback guide.
docs/​durable-functions.md	Removes local durable functions guide.
docs/​domains.md	Removes local domain verification guide.
docs/​docs-search.md	Removes local documentation search guide.
docs/​deployments.md	Removes local deployment history guide.
docs/​deploy.md	Removes local project deployment guide.
docs/​databases.md	Removes local databases guide.
docs/​connect.md	Removes local directory connection guide.
docs/​authentication.md	Removes local authentication guide.
docs/​agent-detection.md	Removes local agent detection guide.
docs/​access-tokens.md	Removes local access token guide.
CONTRIBUTING.md	Points installation guidance to the published site.
AGENTS.md	Replaces local docs updates with linked companion PRs.
.github/​workflows/​lint-docs.yml	Removes linting for the deleted documentation directory.

_{Review effort: Balanced}