From 54922fa1a60e447f94f1ca28423da4815ce5f426 Mon Sep 17 00:00:00 2001 From: diegosouzapw Date: Fri, 7 Aug 2026 04:40:04 -0300 Subject: [PATCH] docs(proxy): use an RFC 5737 documentation IP in the proxy examples MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The #9298 verdict headlines its docs failure with `L810 [stale-version] 1.2.3: const removed = await failOneproxyProxy("1.2.3.4", 8080)`. That is a false positive: check-deprecated-versions.mjs matches `/\bv?[12]\.\d+\.\d+\b/`, and the example IP literal 1.2.3.4 contains "1.2.3". Swapped both occurrences in PROXY_GUIDE.md (and its pl mirror) for 203.0.113.7, from the RFC 5737 documentation range that exists precisely for examples — it cannot collide with a version pattern and is the correct thing to print in docs regardless. Drift count 64 -> 62; no gate threshold was touched. The gate that actually FAILED under "Docs sync + fabricated-docs (strict)" was check:fabricated-docs (the invented pool env vars), fixed in the previous commit; this one removes the misleading line the verdict quotes. --- docs/i18n/pl/docs/ops/PROXY_GUIDE.md | 4 ++-- docs/ops/PROXY_GUIDE.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/i18n/pl/docs/ops/PROXY_GUIDE.md b/docs/i18n/pl/docs/ops/PROXY_GUIDE.md index 044a3ae69c..af1e0a812f 100644 --- a/docs/i18n/pl/docs/ops/PROXY_GUIDE.md +++ b/docs/i18n/pl/docs/ops/PROXY_GUIDE.md @@ -645,7 +645,7 @@ for (const s of statuses) { } // Force re-check a specific proxy -invalidateProxyHealth("http://user:pass@1.2.3.4:8080"); +invalidateProxyHealth("http://user:pass@203.0.113.7:8080"); ``` Flaga `stale` jest `true`, gdy wpis cache przekroczył `HEALTH_CACHE_TTL_MS` i następne żądanie wywoła świeży check. @@ -807,7 +807,7 @@ Gdy proxy systematycznie pada, oznacz je ręcznie, by rotator je pomijał: ```ts import { failOneproxyProxy } from "omniroute/oneproxyRotator"; -const removed = await failOneproxyProxy("1.2.3.4", 8080); +const removed = await failOneproxyProxy("203.0.113.7", 8080); if (removed) { console.log("Proxy marked as failed; rotator will skip it"); } diff --git a/docs/ops/PROXY_GUIDE.md b/docs/ops/PROXY_GUIDE.md index ce588c988d..81535d1cbf 100644 --- a/docs/ops/PROXY_GUIDE.md +++ b/docs/ops/PROXY_GUIDE.md @@ -645,7 +645,7 @@ for (const s of statuses) { } // Force re-check a specific proxy -invalidateProxyHealth("http://user:pass@1.2.3.4:8080"); +invalidateProxyHealth("http://user:pass@203.0.113.7:8080"); ``` The `stale` flag is `true` when the cache entry has exceeded `HEALTH_CACHE_TTL_MS` and the next request will trigger a fresh check. @@ -807,7 +807,7 @@ When a proxy consistently fails, mark it manually so the rotator will skip it: ```ts import { failOneproxyProxy } from "omniroute/oneproxyRotator"; -const removed = await failOneproxyProxy("1.2.3.4", 8080); +const removed = await failOneproxyProxy("203.0.113.7", 8080); if (removed) { console.log("Proxy marked as failed; rotator will skip it"); }