Skip to content

docs: slim README and move reference content to docs/#627

Open
fain182 wants to merge 1 commit into
mainfrom
claude/docs-improvement-626-absae5
Open

docs: slim README and move reference content to docs/#627
fain182 wants to merge 1 commit into
mainfrom
claude/docs-improvement-626-absae5

Conversation

@fain182

@fain182 fain182 commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • README trimmed from 686 to ~80 lines — now covers only hero, quick start, core concepts, a rules index table, and links to further reading
  • Full rule catalog + rule builders extracted to docs/rules.md
  • All CLI options, commands (init, debug:expression), baseline, output formats, and Phar usage unified into docs/configuration.md (previously scattered across three separate README sections)

Partial fix for #626 — new content (cookbook, custom-rules, tool comparison) is deferred to a follow-up PR.

Test plan

  • README renders correctly on GitHub (badges, code blocks, tables, links to docs/)
  • docs/rules.md — all rule examples are present and correct
  • docs/configuration.md — all CLI options match the reference table; commands and baseline sections are accurate
  • Internal links between README and docs/ resolve correctly on GitHub

🤖 Generated with Claude Code


Generated by Claude Code

README trimmed from 686 to ~80 lines — now covers only hero, quick start,
core concepts, a rules index, and links to further reading.

Full rule catalog (rules.md) and all configuration / CLI / command reference
(configuration.md) extracted to docs/ so they are searchable and versioned
without cluttering the landing page.

Closes #626 (partial — new content for cookbook, custom-rules, and tool
comparison deferred to a follow-up PR).

Co-Authored-By: Claude <noreply@anthropic.com>
@codecov

codecov Bot commented Jun 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.25%. Comparing base (312101a) to head (d8620b1).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff            @@
##               main     #627   +/-   ##
=========================================
  Coverage     98.25%   98.25%           
  Complexity      700      700           
=========================================
  Files            87       87           
  Lines          2000     2000           
=========================================
  Hits           1965     1965           
  Misses           35       35           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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