docs(ontology): explain thresholds as prose instead of a table

A four-row table was heavier than this needed; each threshold's meaning reads faster as two connected sentences.
docs(ontology): document quality gate threshold semantics
2026-09-04 04:01:07 +00:00 · 2026-09-03 23:35:33 +05:30 · 2026-09-03 23:32:05 +05:30
1 changed files with 4 additions and 0 deletions
@@ -110,6 +110,10 @@ range references, and unresolved KG relationship endpoints. It includes
 machine-readable issue codes, severity, counts, metrics, and threshold
 failures. The first version reports findings only; it does not auto-fix data.

+### Thresholds
+
+`min_coverage` (default `0.0`) sets the minimum required `coverage` score, the average of class and property coverage from `0.0` to `1.0`; the gate fails below it. `max_errors` (default `0.0`) caps how many `error`/`critical` issues are allowed before the gate fails. `max_warnings` (default `None`) caps `warning` issues the same way, and `None` means warnings alone never fail the gate. `fail_on_warnings` is a separate parameter, not a `thresholds` key, passed to `OntologyQualityGate(...)` or `.check(...)` directly; when `True`, a single warning fails the gate regardless of `max_warnings`.
+
 ## OntologyGenerator (5-Stage Pipeline)

 **`OntologyGenerator`** auto-generates a formal ontology from your knowledge graph entities and relationships: