diff --git a/README.md b/README.md index 9ed5805..83f9226 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,26 @@ without requiring an external database. --- +## No DNS mocking. Ever. + +**DNS is never mocked in this project — not in tests, not anywhere else.** +No mock resolvers, no fake DNS servers, no stubbed lookups. + +dnswatcher's entire purpose is correct behavior against the real DNS. +Tests exercise real iterative resolution against live nameservers by +design; a test suite that passes against a mock proves nothing about the +one thing this program exists to do. + +When live tests are flaky, that is a robustness problem, and it gets +fixed with robustness: retries with backoff, querying multiple +independent nameservers, longer timeouts — or explicit opt-in gating +decided by the project owner. Never with mocks. + +Contributions that introduce mocked, faked, or stubbed DNS will be +rejected. + +--- + ## Features ### DNS Domain Monitoring (Apex Domains)