docs: document the inline slop:allow directive + test-file auto-detection #1

Merged

peersky merged 2 commits from docs/inline-allow-directive into dev 2026-08-15 15:26:54 +00:00

Conversation 0 Commits 2 Files changed 4 +90 -6

peersky commented 2026-08-15 15:21:34 +00:00

Owner

Copy link

The inline // slop:allow <categories>[: reason] escape hatch is now
enforced by the detector, so document it as a first-class way to
suppress a false positive: a new how-to covering directive scopes
(same-line suffix, standalone next-line), comment markers, the *
wildcard, and when to reach for slop learn instead. The catalog's
context-gating section gains the directive and the newly recognised
bare tests.rs / test.rs module-file convention.

The inline `// slop:allow <categories>[: reason]` escape hatch is now enforced by the detector, so document it as a first-class way to suppress a false positive: a new how-to covering directive scopes (same-line suffix, standalone next-line), comment markers, the `*` wildcard, and when to reach for `slop learn` instead. The catalog's context-gating section gains the directive and the newly recognised bare `tests.rs` / `test.rs` module-file convention.

peersky added 1 commit 2026-08-15 15:21:34 +00:00

docs: document the inline slop:allow directive + test-file auto-detection ... 1c0905c0ef

The inline `// slop:allow <categories>[: reason]` escape hatch is now
enforced by the detector, so document it as a first-class way to
suppress a false positive: a new how-to covering directive scopes
(same-line suffix, standalone next-line), comment markers, the `*`
wildcard, and when to reach for `slop learn` instead. The catalog's
context-gating section gains the directive and the newly recognised
bare `tests.rs` / `test.rs` module-file convention.

peersky added 1 commit 2026-08-15 15:24:45 +00:00

feat(cli): surface the slop:allow directive in help + verdict hint ... 947566db71

The inline `// slop:allow <category>: reason` escape hatch was only in
the docs. Add it where operators actually look: the `slop poke`
verdict footer (printed on every SLOP result), the `--disable` help
text (as its persistent in-source counterpart), and the installed
pre-commit hook's mute guidance.

peersky merged commit 1f960b91a8 into dev 2026-08-15 15:26:54 +00:00

peersky deleted branch docs/inline-allow-directive 2026-08-15 15:26:54 +00:00

peersky referenced this pull request from a commit 2026-08-15 15:26:56 +00:00

Merge pull request 'docs: document the inline slop:allow directive + test-file auto-detection' (#1) from docs/inline-allow-directive into dev

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

peeramid-labs/slop-cli!1

No description provided.