Skip to content

docs: refresh README sample output to match what commit-check prints - #535

Merged
shenxianpeng merged 1 commit into
mainfrom
claude/refresh-readme-output-602anc
Aug 7, 2026
Merged

docs: refresh README sample output to match what commit-check prints#535
shenxianpeng merged 1 commit into
mainfrom
claude/refresh-readme-output-602anc

Conversation

@shenxianpeng

@shenxianpeng shenxianpeng commented Aug 7, 2026

Copy link
Copy Markdown
Member

Why

The README's output blocks predate rule IDs, so they show neither the CCxxx identifiers nor the Docs: links that every failure now prints. This is the same staleness #530 fixed in the demo GIF — the docs site is already current, only the README was left behind.

What changed

Every block was produced by running the documented command against this checkout, not by editing prose.

The two ## Examples blocks

before now
prefix Type message check failed CC001 message check failed
commit types … test, chore, ci … test, chore, perf, build, ci
trailing line Docs: https://commit-check.com/rules/#cc001

Same for the branch block: Type branch check failedCC201 branch check failed, plus its Docs: line.

Four more blocks, same defect

  • --no-banner carried a line that no longer exists anywhere in the source:
    It doesn't match regex: ^(build|chore|ci|…). A grep over *.py finds it only in a test comment.
  • --compact prints the rule id: [FAIL] CC001 message: …
  • Both --format json examples were missing the rule_id and docs_url fields, showed value as "" where it is now populated on pass, and named a subject_imperative check the default run does not emit — it reports subject_max_length (CC004) and subject_min_length (CC005), and lists passing checks alongside the failing one.
  • The Python API return-value schema was missing rule_id and docs_url. The API code examples were correct — each was re-run to confirm the documented status values still hold.

Verification

After editing, each block was re-captured from a live run and compared byte for byte against the committed text — JSON via json.loads, text with ANSI colours and trailing padding normalised. All six match. These are transcripts, not transcriptions.

Docs-only; no code or test changes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01U9zFxq8V4qxG4aMzJhGBFn


Generated by Claude Code

The README's output blocks predate rule IDs, so they showed neither the
CCxxx identifiers nor the Docs links that every failure now prints. Same
staleness #530 fixed in the demo GIF; the docs site is already current,
only the README had been left behind.

Measured by running each documented command against this checkout rather
than reading the code:

  Type message check failed ==> ...   ->  CC001 message check failed ==> ...
  Type branch check failed  ==> ...   ->  CC201 branch check failed  ==> ...

plus a trailing `Docs: https://commit-check.com/rules/#ccNNN` line on both,
and two commit types the list had never picked up (perf, build).

Four more blocks were stale in the same way, so they are refreshed too:

- --no-banner carried a line that no longer exists anywhere in the source:
  "It doesn't match regex: ^(build|chore|ci|...)". grep over *.py finds it
  only in a test comment.
- --compact prints the rule id: [FAIL] CC001 message: ...
- Both --format json examples were missing the rule_id and docs_url fields,
  showed value as "" where it is now populated on pass, and named a
  subject_imperative check that the default run does not emit — it reports
  subject_max_length (CC004) and subject_min_length (CC005), and lists
  passing checks alongside the failing one.
- The Python API return-value schema was missing rule_id and docs_url. The
  API code examples themselves were correct; each was re-run to confirm.

Every block was then re-captured and compared byte for byte against the
committed text (JSON via json.loads, text with ANSI colours and trailing
padding normalised), so these are transcripts, not transcriptions.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U9zFxq8V4qxG4aMzJhGBFn
@shenxianpeng
shenxianpeng requested a review from a team as a code owner August 7, 2026 09:41
@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@shenxianpeng, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 55 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 36bfacfe-2b53-403c-9d0f-55b6b0041359

📥 Commits

Reviewing files that changed from the base of the PR and between 08d14c1 and 56fc489.

📒 Files selected for processing (1)
  • README.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 7, 2026
@sonarqubecloud

sonarqubecloud Bot commented Aug 7, 2026

Copy link
Copy Markdown

@shenxianpeng
shenxianpeng merged commit 90c5abe into main Aug 7, 2026
8 checks passed
@shenxianpeng
shenxianpeng deleted the claude/refresh-readme-output-602anc branch August 7, 2026 09:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant