diff --git a/README.md b/README.md
index 21349e2..327a910 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
 # idea-personal-event-srv
 
-idea around a personal event server
\ No newline at end of file
+idea around a personal event server
+
+## overview
+
+Ideally it would be a network of agents, that can broadcast and see messages, only responding to interested events.
+A brokerless setup.
+Further, having one or more endpoints for recieving, and even calling webhooks.
+The webhooks must be a specified node.
+Perhaps the webhooks recieved would broadcast a message on the node network, and specific types of node network messages would translate out to calling a webhook.
+
+# references
+
+* https://github.com/adnanh/webhook
+* https://github.com/zeromq/zyre
+  * https://github.com/zeromq/czmq
+  * https://github.com/zeromq/gomq
+* https://github.com/ethereum/wiki/wiki/Whisper
+  * https://archive.fosdem.org/2018/schedule/event/whisper/
+* https://www.consul.io/
+