diff --git a/docs/api/async-logger-with-filter.md b/docs/api/async-logger-with-filter.md index af66b1b..7155b15 100644 --- a/docs/api/async-logger-with-filter.md +++ b/docs/api/async-logger-with-filter.md @@ -41,6 +41,7 @@ Detailed rules explaining key parameters and behaviors - Existing filter logic is preserved and combined with the new predicate using logical `and`. - The original async logger is not mutated. - Filtering avoids unnecessary queue pressure for records that should never be delivered. +- In the current direct async coverage, derived filters can compose target, level, and message predicates together while the original logger still accepts writes according to its previous filter state. ### How to Use @@ -80,3 +81,5 @@ e.g.: 1. Use this API for selection logic, not record mutation. 2. Async filtering is especially useful when queue capacity should be reserved for high-value records. + +3. Use a derived logger value when one branch should enforce extra filter rules and the base async logger should stay unchanged. diff --git a/docs/api/async-logger-with-min-level.md b/docs/api/async-logger-with-min-level.md index 0cf1bc3..32a365d 100644 --- a/docs/api/async-logger-with-min-level.md +++ b/docs/api/async-logger-with-min-level.md @@ -41,6 +41,7 @@ Detailed rules explaining key parameters and behaviors - Lower-severity records below `min_level` are skipped before enqueue. - This API replaces the logger threshold and does not alter queue configuration. - The returned logger keeps the same sink, target, and timestamp settings. +- In the current direct async coverage, the derived logger reports the new threshold through `is_enabled(...)`, while the original logger keeps its previous minimum level and still accepts records that remain enabled there. ### How to Use @@ -78,3 +79,5 @@ e.g.: 1. This API reduces async queue pressure by dropping disabled levels before enqueue. 2. Use it before adding more complex async filtering rules. + +3. Use a derived logger value when one branch should tighten the threshold and the base async logger should keep its broader level gate. diff --git a/docs/api/async-logger-with-patch.md b/docs/api/async-logger-with-patch.md index 4d691b9..c084226 100644 --- a/docs/api/async-logger-with-patch.md +++ b/docs/api/async-logger-with-patch.md @@ -41,6 +41,7 @@ Detailed rules explaining key parameters and behaviors - Existing patch logic is preserved and composed so the new patch wraps the current one. - The original async logger is not mutated. - Patching can normalize, redact, or enrich records before they consume queue capacity. +- In the current direct async coverage, patched target/message/field changes are visible to later filter logic, and the original async logger still emits unpatched records when used separately. ### How to Use @@ -80,3 +81,5 @@ e.g.: 1. Use patches for transformation, not filtering decisions. 2. Redaction before enqueue helps keep sensitive data out of the queued pipeline. + +3. Derive a patched logger when one path needs rewritten records and another should keep the original async record shape.