Skip to content

fix: correct CLI docs against kbc --help source of truth (PRDCT-370) - #397

Open
Iamfle4ka wants to merge 2 commits into
mainfrom
devin/1782145879-PRDCT-370-cli-audit-fixes
Open

fix: correct CLI docs against kbc --help source of truth (PRDCT-370)#397
Iamfle4ka wants to merge 2 commits into
mainfrom
devin/1782145879-PRDCT-370-cli-audit-fixes

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Jira issue(s): PRDCT-370

Changes:

Fixes PRDCT-370 — unambiguous code-accuracy divergences found by auditing all 57 /cli/ pages against kbc --help built from keboola/keboola-as-code HEAD.

Inaccurate values corrected:

  • --ci-pull frequency: docs said "every 5 minutes" → CLI + workflow template cron (0 * * * *) say "each hour" (sync init, ci workflows pages)
  • --timeout default on remote job run and remote table unload: docs said 2m → CLI says 5m
  • local persist alias: docs said kbc p → CLI alias is kbc pt (alias table in commands/index.md was already correct)
  • dbt generate env page: description said "Generates sources" and usage showed kbc dbt generate sources → copy-paste error, fixed to env
  • local create row example used kbc create config → fixed to kbc create row
  • remote file upload example used --name/--tags → fixed to --file-name/--file-tags

Broken links fixed:

  • kbc remote workspace row in commands/index.md and remote/index.md linked to /remote/create//remote/workspace/
  • "Create Branch" Next Steps link in local/create/config and local/create/row had typo brabchbranch

Missing flags added:

  • --without-decompress on remote file download
  • --cleanup on local fix-paths
  • --timeout on remote table download

All changes match kbc --help output verbatim. No needs_human items are included.


Full audit log (Block 0/A/B/C + summary) posted as a comment on PRDCT-370.

Release Notes

Justification, description

Documentation accuracy fixes — correcting flag defaults, aliases, broken links, and missing flags that diverged from the CLI source of truth.

Plans for Customer Communication

N/A

Impact Analysis

N/A — docs-only changes, no code or API impact.

Deployment Plan

Standard docs deployment via merge to main.

Rollback Plan

Revert PR.

Post-Release Support Plan

N/A

Link to Devin session: https://app.devin.ai/sessions/2dceb9b7d73f47f890612ddba70f681d
Requested by: @Iamfle4ka

- Fix --ci-pull frequency: 'every 5 minutes' → 'each hour' (sync init, ci workflows)
- Fix --timeout defaults: '2m' → '5m' (job run, table unload)
- Fix persist alias: 'kbc p' → 'kbc pt, persist'
- Fix dbt generate env: wrong description and usage (was copy-pasted from sources)
- Fix create row example: 'kbc create config' → 'kbc create row'
- Fix workspace link: pointed to /remote/create/ instead of /remote/workspace/
- Fix 'brabch' typo in Next Steps links → 'branch'
- Fix file upload example: '--name/--tags' → '--file-name/--file-tags'
- Add missing --without-decompress flag (file download)
- Add missing --cleanup flag (fix-paths)
- Add missing --timeout flag (table download)

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@Iamfle4ka Iamfle4ka self-assigned this Jun 22, 2026
@devin-ai-integration

Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@linear

linear Bot commented Jun 22, 2026

Copy link
Copy Markdown

PRDCT-370

@Iamfle4ka
Iamfle4ka marked this pull request as ready for review July 10, 2026 13:53

@keboola-pr-reviewer-bot keboola-pr-reviewer-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: needs_human (risk 2/5) · profile docs

Needs human: CLI flag defaults/aliases/frequencies are product-behaviour claims the bot can't verify, and one new option has a copy-paste defect.

Concerns:

  • cli/commands/remote/table/download/index.md: New --timeout says "unload job" (copy-paste) and keeps 2m vs unload's 5m
  • cli/commands/remote/job/run/index.md: --timeout default 2m→5m is an unverifiable product-behaviour claim
  • cli/commands/local/persist/index.md: Diff adds kbc persist alias not mentioned in PR body; unverifiable

Suggested reviewers: @keboola/docs

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.

2 participants