v0.1.2-pre.006

crates/ksp-logging-lib/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-logging-lib/USAGE.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Utilisation de ksp-logging-lib
 
@@ -116,3 +116,15 @@ ksp_logging_lib::warn!(
     "logging queues dropped lines"
 );
 ```
+
+## Instrumentation async et executor
+
+`instrument(span, future)` accepte une `Future` standard et ne dépend d'aucun executor particulier :
+
+```rust
+let span = ksp_logging_lib::trace_span!(target: LOGGING_TARGET, "load_transactions");
+let result = ksp_logging_lib::instrument(span, async_operation()).await;
+```
+
+La crate ne requiert pas Tokio en production. Tokio n'est présent qu'en `dev-dependency` pour valider la surface sur un executor réel, y compris après plusieurs suspensions et sur un runtime multi-thread. Un consumer peut donc utiliser l'executor adapté à son propre contexte sans que Logging lui en impose un.
+