Skip to content

docs: update documentation links to commit-check.com - #518

Merged
shenxianpeng merged 1 commit into
mainfrom
docs/point-links-at-commit-check-com
Aug 4, 2026
Merged

docs: update documentation links to commit-check.com#518
shenxianpeng merged 1 commit into
mainfrom
docs/point-links-at-commit-check-com

Conversation

@shenxianpeng

@shenxianpeng shenxianpeng commented Aug 4, 2026

Copy link
Copy Markdown
Member

The documentation moved to commit-check/commit-check.com, where it is served from the apex domain alongside the landing page and the blog.

This is the URL-only half of the migration. It is safe to merge before the new site is live, because docs.commit-check.com keeps serving until it is retired.

Changes

File Change
commit_check/rules_catalog.py RULES_DOCS_URLhttps://commit-check.com/rules/
pyproject.toml documentation project URL
README.md 4 links, also moved off the Sphinx-era .html URLs

RULES_DOCS_URL is the one that matters. It is embedded in every failure message the tool prints, so it has to be right before the next release makes it permanent. It has not shipped to PyPI yet, which is the only reason changing it is still free.

The CLI reference page no longer exists — the flags it listed are documented alongside the settings that control them — so cli_args.html now points at the configuration page.

Not in this PR

Removing docs/, mkdocs.yml, netlify.toml, the docs CI job and the six documentation-consistency tests. Doing that before the new site has DNS and Pages configured would leave a window with no documentation on either domain, so it wants a separate change once commit-check.com is verified live.

Verification

460 passed, 1 failed — the failure is test_load_config_file_permission_error, which uses os.chmod(0o000) and cannot fail as root; it is unrelated to this change and fails the same way on main.

Summary by CodeRabbit

  • Documentation
    • Updated project documentation links to use the new commit-check.com domain.
    • Refreshed links for installation, configuration, usage examples, and rule documentation.

@shenxianpeng
shenxianpeng requested a review from a team as a code owner August 4, 2026 05:25
@netlify

netlify Bot commented Aug 4, 2026

Copy link
Copy Markdown

Deploy Preview for commit-check ready!

Name Link
🔨 Latest commit 7430d18
🔍 Latest deploy log https://app.netlify.com/projects/commit-check/deploys/6a71793c64992100077e9fc4
😎 Deploy Preview https://deploy-preview-518--commit-check.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

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

Next review available in: 53 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: ae032a48-bf61-43f9-9b54-3083d4efdd71

📥 Commits

Reviewing files that changed from the base of the PR and between 5900147 and 7430d18.

📒 Files selected for processing (5)
  • .gitignore
  • README.md
  • commit_check/rules_catalog.py
  • pyproject.toml
  • tests/rules_catalog_test.py
📝 Walkthrough

Walkthrough

The pull request replaces the old documentation host with commit-check.com in README links, project metadata, and rule catalog documentation URLs.

Changes

Documentation URL update

Layer / File(s) Summary
Public documentation links
README.md, pyproject.toml
README links and the project documentation metadata now use commit-check.com.
Rule catalog documentation links
commit_check/rules_catalog.py
RULES_DOCS_URL now points to the new rules documentation path.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

Suggested labels: skip-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the documentation link updates in the pull request.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/point-links-at-commit-check-com

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.

@codecov

codecov Bot commented Aug 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.43%. Comparing base (6751073) to head (7430d18).

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #518      +/-   ##
==========================================
+ Coverage   97.34%   97.43%   +0.08%     
==========================================
  Files          12       12              
  Lines        1207     1207              
==========================================
+ Hits         1175     1176       +1     
+ Misses         32       31       -1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
commit_check/rules_catalog.py (1)

24-24: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Assert the migrated host in the catalog test.

tests/rules_catalog_test.py Lines 63-66 derives the expected URL from RULES_DOCS_URL. The test therefore passes if this change accidentally reverts to the old host. Add an explicit assertion for the new host and /rules/ path.

Suggested test assertion
         assert entry.docs_url == f"{RULES_DOCS_URL}`#cc003`"
+        assert entry.docs_url == "https://commit-check.com/rules/#cc003"
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@commit_check/rules_catalog.py` at line 24, Update the catalog test covering
RULES_DOCS_URL to explicitly assert the migrated host and the “/rules/” path,
rather than deriving the expected value solely from RULES_DOCS_URL. Preserve the
existing catalog validation while ensuring the test fails if the URL reverts to
the old host.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 426: Update the user-facing sentence in the README around the example
documentation link from “More examples see” to “For more examples, see,”
preserving the existing link and punctuation.

---

Nitpick comments:
In `@commit_check/rules_catalog.py`:
- Line 24: Update the catalog test covering RULES_DOCS_URL to explicitly assert
the migrated host and the “/rules/” path, rather than deriving the expected
value solely from RULES_DOCS_URL. Preserve the existing catalog validation while
ensuring the test fails if the URL reverts to the old host.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b882ccf-92f1-480e-853b-833bbe00f2bb

📥 Commits

Reviewing files that changed from the base of the PR and between 6751073 and 5900147.

📒 Files selected for processing (3)
  • README.md
  • commit_check/rules_catalog.py
  • pyproject.toml

Comment thread README.md Outdated
@shenxianpeng
shenxianpeng force-pushed the docs/point-links-at-commit-check-com branch from 5900147 to bc96b74 Compare August 4, 2026 05:30
@github-actions github-actions Bot added the tests Add test related changes label Aug 4, 2026
@shenxianpeng shenxianpeng changed the title docs: point documentation links at commit-check.com docs: update documentation links to commit-check.com Aug 4, 2026
The documentation moved to its own repository and is served from the apex
domain alongside the landing page and the blog.

RULES_DOCS_URL matters most here: it is embedded in every failure message
the tool prints, so it has to be correct before the next release makes it
permanent. A test now pins the base URL rather than deriving expectations
from it, so a wrong or reverted value fails instead of being followed.

The CLI reference page is gone, and the flags it listed are documented
alongside the settings that control them, so those links now point at the
configuration page.
@shenxianpeng
shenxianpeng force-pushed the docs/point-links-at-commit-check-com branch from 8698550 to 7430d18 Compare August 4, 2026 05:31
@sonarqubecloud

sonarqubecloud Bot commented Aug 4, 2026

Copy link
Copy Markdown

@shenxianpeng shenxianpeng removed the tests Add test related changes label Aug 4, 2026
@shenxianpeng
shenxianpeng merged commit c28097b into main Aug 4, 2026
32 checks passed
@shenxianpeng
shenxianpeng deleted the docs/point-links-at-commit-check-com branch August 4, 2026 05:35
@codspeed-hq

codspeed-hq Bot commented Aug 4, 2026

Copy link
Copy Markdown

Merging this PR will improve performance by ×12

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 1 improved benchmark
✅ 402 untouched benchmarks
🆕 1 new benchmark
⏩ 116 skipped benchmarks1

Performance Changes

Benchmark BASE HEAD Efficiency
test_empty_message_passes 28 ms 2.3 ms ×12
🆕 test_docs_url_points_at_the_published_site N/A 242.4 µs N/A

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.


Comparing docs/point-links-at-commit-check-com (7430d18) with main (6751073)

Open in CodSpeed

Footnotes

  1. 116 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

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