34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# John Slop documentation
|
|
|
|
The root [README](../README.md) is the short project overview. These guides hold
|
|
the details needed to use, embed, and develop John Slop:
|
|
|
|
- [Runnable Rust examples](../examples/README.md) demonstrate in-memory
|
|
analysis, streaming path input, and shared replacement planning.
|
|
- [Usage](usage.md) documents accepted inputs, detector output, exit statuses,
|
|
and the current formatter/LSP status.
|
|
- [Editor setup](editors.md) provides Helix (`hx`) and Vim configuration for
|
|
the formatter and future LSP adapter, with current status caveats.
|
|
- [Output contracts](output.md) specifies human and concise presentation plus
|
|
the versioned JSON Lines schema and partial-error records.
|
|
- [Architecture](architecture.md) describes module boundaries, shared domain
|
|
values, input safety, and the reusable library facade.
|
|
- [Configuration](configuration.md) documents schema version 1, source
|
|
precedence, stable-ID merges, validation, and inspection commands.
|
|
- [Heuristics and confidence](heuristics.md) documents rule execution,
|
|
applicability, evidence damping, normalization, and score interpretation.
|
|
- [Evaluation corpus](evaluation.md) records fixture provenance, per-rule
|
|
precision/recall, aggregate false positives, and benchmark caveats.
|
|
- [Limitations](limitations.md) covers false positives, evasion, domain shift,
|
|
score semantics, evaluation limits, and operational boundaries.
|
|
- [Development](development.md) covers the supported Rust version, feature
|
|
matrix, snapshots, coverage, badges, and CI quality gates.
|
|
- [Background](background.md) collects external context on observable signs of
|
|
low-care AI-assisted writing.
|
|
- [Decision records](decisions/) preserve durable product and engineering
|
|
choices, including confidence semantics and input limits.
|
|
|
|
Future LSP and release-hardening contracts remain specified in
|
|
[tasks.md](../tasks.md) and [AGENTS.md](../AGENTS.md) until their implementation
|
|
milestones land.
|