📝 Refine API doc notes and guidance

This commit is contained in:
Nanaloveyuki
2026-05-12 13:32:15 +08:00
parent 4d913aa642
commit c6c153cf53
47 changed files with 0 additions and 236 deletions
-5
View File
@@ -87,12 +87,7 @@ e.g.:
### Notes
Notes are here.
1. Always pair this API with `native_files_supported()` in cross-target code.
2. Prefer `state()`, `policy()`, and failure counters when integrating diagnostics.
3. Use `reopen_append()` and `reopen_truncate()` for common recovery flows instead of raw `reopen(...)` where possible.
4. For config-driven file logging, the mirrored control surface is exposed through `ConfiguredLogger` and `RuntimeSink`.