docs: sync generated CLI reference - #9818
medriscoll wants to merge 1 commit into
Conversation
nishantmonu51
left a comment
There was a problem hiding this comment.
The two stale page deletions are correct: neither configure nor rename exists under cli/cmd/env/ or cli/cmd/usergroup/ on main.
| Available example projects: | ||
| - rill-cost-monitoring (duckdb) | ||
| - rill-github-analytics (duckdb) | ||
| - rill-openrtb-prog-ads (duckdb) | ||
|
|
||
|
|
There was a problem hiding this comment.
This hunk was not produced by make docs.generate, so docs-check fails on it. make docs.generate depends on runtime.examples.embed (Makefile:33, Makefile:63), which copies the KEEP_EXAMPLES projects into runtime/pkg/examples/embed/dist before running the generator; examples.List() then populates this block from cli/cmd/initialize/init.go:26. The generator also always emits the trailing blank line removed at the end of the file (cli/cmd/docs/generate_cli.go:173). CI regenerates both and fails with "Generated docs are out of date". Dropping this hunk and keeping only the two page deletions is enough.
Summary
rill env configureandrill usergroup renamecommandsrill initreferenceValidation
--helpagainst v0.88.6rill init,rill validate --pull-env=false,rill start, andrill query --localworkflowsnpm ciandnpm run buildindocs/successfully