Commit 6db8e7d
committed
Sweep flip-flopped guidance in AGENTS.md to best-supported wording
Two substantive edits, plus guard rails to keep future review passes
from flipping these claims again.
src/MongoDB.Driver/Core/AGENTS.md
- IDnsResolver substitutability (line 296): Tightened the verbose
three-clause sentence that was hedging across all three prior
positions. Now states internal clearly, explains the interface is
for in-assembly tests via InternalsVisibleTo, and adds an explicit
guard line ("Past versions of this file claimed users could
substitute a custom IDnsResolver; do not re-introduce that claim").
Verified against source: both IDnsResolver and DnsClientWrapper are
internal.
- helloOk version (line 116): Current wording correctly omits a
version number. Added a guard line citing ServerMonitor.cs /
HelloResult.HelloOk as the runtime gate, and explicitly flagging
both prior wrong values ("5.0+" and "4.4.2+") as
not-to-be-reintroduced. Verified against source: ServerMonitor.cs
uses previousDescription?.HelloOk ?? false as the runtime flag.
Left as-is (best state already)
- $polygon recommendation in GeoJsonObjectModel/AGENTS.md: Currently
silent. Silence is correct — the audience for this object model
targets 2dsphere, not legacy 2d, so there's no useful guidance to
give. No edit.
- GuidRepresentationMode.V2/V3 token in Bson/AGENTS.md: Token is
mentioned twice, both times with the consistent claim that the
mode was removed. This was the "token-level wobble" — the claim
never actually flipped, only its surface mention came back.
Keeping the token aids searchers who arrive looking for the old
API; no edit.
Why not more edits
The other near-misses from the audit were monotone refinements
rather than flip-flops, so they didn't need a "pick the best"
decision — the current wording is already the most refined version
(MinPoolSize -> MinConnections, AggregateToCollectionOperation
retryability, DownloadStreamForwardOnly -> Seekable, "internal
sealed" sweeping claim, pool warm-up).1 parent b58abac commit 6db8e7d
1 file changed
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
113 | 113 | | |
114 | 114 | | |
115 | 115 | | |
116 | | - | |
| 116 | + | |
117 | 117 | | |
118 | 118 | | |
119 | 119 | | |
| |||
293 | 293 | | |
294 | 294 | | |
295 | 295 | | |
296 | | - | |
| 296 | + | |
297 | 297 | | |
298 | 298 | | |
299 | 299 | | |
| |||
0 commit comments