Updates

messaging-pubsub/hyper-p2p-topic-channel/README.md

@@ -1,16 +1,16 @@
 # hyper-p2p-topic-channel
 
-Production p2p module: Hyperswarm discovery + Protomux when `topic` is set.
+Named channel pub/sub with optional retained last message — `subscribe`, `publish`, and `syncRetained` over one Hyperswarm topic.
 
-**Category:** General
+**Category:** Messaging pub/sub
 
-**Composes with:** 
+**Composes with:** `hyper-p2p-qos-topic`, `hyper-p2p-subscription-lease`, `hyper-p2p-retained-messages`
 
 **Protocol:** `topic-channel/v1`
 
 ## When to use
 
-Multi-peer apps that need general over a shared Hyperswarm topic.
+Apps that need MQTT-style channels, handler callbacks, and gossiped publish/subscribe on a shared topic.
 
 ## When not to use