Update Programming Guide

Programming-Guide.md

@@ -143,9 +143,14 @@ Or clear everything:
 Ctx.INSTANCE.clear();
 ```
 
-## Multiple Named Contexts
+## Ephemeral Named Contexts
 
-You can create and manage multiple independent contexts identified by names.
+You can create multiple independent, **ephemeral contexts**, each identified by a unique name.
+These contexts behave like isolated key–value stores:
+
+- They are created lazily on first access.
+- They live only as long as you keep a reference to them.
+- They are automatically deregistered once no strong references remain (via the garbage collector), or can be removed explicitly.
 
 ```java
 // Obtain or create named contexts
@@ -172,15 +177,15 @@ Set<String> contexts = Ctx.INSTANCE.contextNames();
 System.out.println("Active contexts: " + contexts);
 ```
 
-Changes in one context do not affect others, allowing modular isolation of data.
+Each context is fully isolated—changes in one do not affect any others—making them suitable for modular scoping (e.g., per-request, per-user, per-transaction).
 
 ## Best Practices
 
-* Define your keys as constants to keep them consistent
+* **Define keys as constants** – centralize Key definitions to avoid typos and ensure consistency across the codebase.
-* Register listeners in classes that depend on context changes
+* **Scope listeners carefully** – register listeners only where reactive updates are needed; remove them when the owning component is disposed. (The framework uses weak references to help, but explicit cleanup is still good practice.)
-* Remove listeners when no longer needed (though weak references help)
+* **Use descriptive, unique key names** – this prevents accidental collisions within a context and improves readability.
-* Use unique key names to avoid collisions within each context
+* **Separate concerns with multiple contexts** – create distinct contexts (e.g., "order", "user", "session") to isolate unrelated data and reduce coupling.
-* Use multiple contexts to logically separate unrelated data
+* **Treat named contexts as ephemeral** – hold onto a CtxInterface only for as long as you need it; once all strong references are gone, the context is automatically reclaimed by the garbage collector.
 
 ## Complete Example