Skip to content

docs: correct active rule count to 64 and complete the issue-type catalog#162

Merged
haroya01 merged 1 commit into
mainfrom
docs/accuracy-pass
Jul 7, 2026
Merged

docs: correct active rule count to 64 and complete the issue-type catalog#162
haroya01 merged 1 commit into
mainfrom
docs/accuracy-pass

Conversation

@haroya01

@haroya01 haroya01 commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Approved Issue

Maintainer accuracy pass — no behavior change (docs + one stale javadoc).

What

  • Unifies the rule count everywhere to the verified truth: 66 IssueType entries, 64 actively emitted, 1 disabled (duplicate-query), 1 reserved (full-scan). Previous copies said 57 (README, index, quickstart, spring-boot, references, architecture), 62 (overview accounting, configuration), or 64+ (CONTRIBUTING).
  • Adds the four missing entries to the reference table and severity/category listings: n-plus-one-suspect, find-by-id-for-association, filesort, temporary-table. The EXPLAIN pair had shipped in the MySQL/PostgreSQL analyzers but was still documented (and javadoc'd) as reserved.
  • Bumps install snippets to 0.4.0 (README, quickstart, spring-boot). Historical references to 0.3.2 (troubleshooting fix note, compatibility floor) are intentionally unchanged.
  • Fixes the docs badge label (query--guard.github.ioharoya01.github.io).
  • Internal architecture docs now reference "the registered DetectionRules" instead of a hardcoded count, so class-count drift can't reoccur there.

Why

The counts had drifted in three directions at once, and the reserved-rule list contradicted the shipped EXPLAIN analyzers. Reviewers checking the numbers against IssueType.java would find the docs wrong on first inspection.

How to test

grep -rnE '\b(57|62)\b' README.md docs CONTRIBUTING.md returns only table row numbers and an unrelated line-number example. Reference table has exactly 64 rows: 11 ERROR / 38 WARNING / 15 INFO.

Checklist

  • ./gradlew build passes (javadoc-only source change)
  • Commit messages follow conventional commits

…alog

The docs claimed 57 detection rules (README, index, guides) while the
IssueType enum has grown to 66 entries, 64 of which are actively
emitted. filesort and temporary-table were still listed as reserved even
though the MySQL/PostgreSQL EXPLAIN analyzers emit them, and
n-plus-one-suspect and find-by-id-for-association were missing from the
reference table. Reserved is now full-scan only.

Also bumps install snippets to 0.4.0, fixes the docs badge label, and
corrects the stale reserved-rule javadoc on IssueType.
@haroya01
haroya01 merged commit 1103ece into main Jul 7, 2026
3 checks passed
@haroya01
haroya01 deleted the docs/accuracy-pass branch July 7, 2026 17:10
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.

1 participant