pubsub documentation first draft

I have made a draft of a pubsub interface for InfluxDB. The code is 90% ready to being considered v1.0, but I figured I would send the documentation over beforehand so that any changes can still be made. Please read it over and let me know what you think!
The way this sounds, it's really more like polling. How is this implemented under the hood? In my mind, pubsub would require either a binary protocol connection, SSE, or web sockets or something so the data can be pushed down to the client.