Skip to content

docs: add CLI output and verbosity reference page#242

Merged
dangrondahl merged 1 commit into
mainfrom
205-document-cli-warning-behavior-and-output-verbosity-controls
May 29, 2026
Merged

docs: add CLI output and verbosity reference page#242
dangrondahl merged 1 commit into
mainfrom
205-document-cli-warning-behavior-and-output-verbosity-controls

Conversation

@dangrondahl
Copy link
Copy Markdown
Contributor

@dangrondahl dangrondahl commented May 29, 2026

Summary

  • New client_reference/output_and_verbosity.md documenting stdout/stderr split, [warning] semantics, the --quiet/--debug flags (and their precedence), and CI/CD log multiplexing guidance.
  • Splits the CLI Reference "General" nav group into General (intro pages) and Top-level commands (auto-generated single-word kosli ... commands).
  • Updates scripts/update-cli-nav.py so the next auto-regen on a CLI release preserves this structure and skips the manually-maintained output_and_verbosity.md page.
  • Adds cross-links from client_reference/overview.md and troubleshooting/subshell_stderr.md.

Closes #205

Test plan

  • mint broken-links passes
  • mint dev — verify the new page renders and appears under CLI Reference → General
  • Visual check of the nav: General contains overview + output_and_verbosity; Top-level commands contains the flat kosli ... entries

@dangrondahl dangrondahl requested a review from a team as a code owner May 29, 2026 07:26
@dangrondahl dangrondahl linked an issue May 29, 2026 that may be closed by this pull request
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 29, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview May 29, 2026, 7:26 AM

@dangrondahl dangrondahl merged commit 93ea621 into main May 29, 2026
9 checks passed
@dangrondahl dangrondahl deleted the 205-document-cli-warning-behavior-and-output-verbosity-controls branch May 29, 2026 07:34
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.

Document CLI warning behavior and output verbosity controls

2 participants