Skip to content

docs(readme): catch up on commands shipped since v0.0.1-rc-5#101

Merged
blue4209211 merged 2 commits into
mainfrom
docs/readme-catchup-oss
Jun 29, 2026
Merged

docs(readme): catch up on commands shipped since v0.0.1-rc-5#101
blue4209211 merged 2 commits into
mainfrom
docs/readme-catchup-oss

Conversation

@blue4209211

Copy link
Copy Markdown
Contributor

Summary

README catch-up before the OSS launch. The README hasn't been updated since the OSS-readiness scaffolding in #75 (May), so several command groups added since then were missing entirely.

New sections

  • `nbctl audit-logs list`
  • `nbctl events list-rules` / `list-triage-rules` / `list-duplicates` (subsections under existing `events`)
  • `nbctl slo list` / `get`
  • `nbctl tickets list-configurations` / `create`
  • `nbctl workflow` — entire command group was missing (`list`, `get`, `apply`, `validate`, `delete`, `trigger`, `pause`, `resume`, `list-executions`, `get-execution`, `cancel-execution`)

Updated

  • Features list — mentions the new resources, MCP server, workflow lifecycle, and ticket integrations.
  • Go version requirement: `1.16+` → `1.25+` (matches `go.mod`).
  • Testing section — documents the e2e build tag and `make test-e2e` target introduced in test(cli): move integration tests behind a build tag #95.

No code changes.

Stats

+288 / -7 lines. README is now 966 lines (up from 685).

🤖 Generated with Claude Code

The README hadn't been updated since the OSS-readiness scaffolding in
#75 (May), so several command groups added since then were missing
entirely. This commit documents them and brings install + testing
sections in line with current state.

New sections:
- nbctl audit-logs list
- nbctl events list-rules / list-triage-rules / list-duplicates
- nbctl slo list / get
- nbctl tickets list-configurations / create
- nbctl workflow list / get / apply / validate / delete / trigger /
  pause / resume / list-executions / get-execution / cancel-execution

Updated:
- Features list — mentions the new resources, MCP server, workflow
  lifecycle, and ticket integrations.
- Go version requirement: 1.16+ -> 1.25+ (matches go.mod).
- Testing section: documents the e2e build tag and `make test-e2e`
  target introduced in #95.

No code changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the README documentation to reflect new CLI capabilities in nbctl, including commands for audit logs, event rules, SLOs, ticket integrations, and workflow management. It also updates the Go installation requirement to version 1.25 or higher and documents the updated end-to-end testing procedures. The reviewer suggested replacing the unquoted <event-id> placeholder in the bash example with a quoted string to prevent shell redirection issues.

Comment thread README.md
- Add 4 shields.io badges at the top: CI status, latest release,
  license, and Go version. Standard OSS signal at first glance.
- Add a top-of-document Quickstart: install -> configure ->
  run one command in under a minute. Sits between Installation
  and the deep-dive Configuration section so new users don't
  have to scroll past 100+ lines of reference before seeing
  anything actionable.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@blue4209211 blue4209211 merged commit d39ca9a into main Jun 29, 2026
1 check 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.

2 participants