diff --git a/readme.md b/readme.md
index 7941c56cf9082aea4ce3c4d7423cef8fdb1cbd7d..cd8a2fc798e376395cdaa4d370a09dd6e421a5d8 100644
--- a/readme.md
+++ b/readme.md
@@ -2,6 +2,10 @@
 
 this is a bottom up implementation of jsonrpc2, primarily made for hosting eth-like jsonrpc requests.
 
+we extend the eth-rpc reflect based handler with go-http style request/response. 
+
+we also make things like subscriptions additional extensions, so they are no longer baked into the rpc package. 
+
 most users should only ever need to access the "jrpc" and "pkg/codec" packages
 
 it is currently being used in the oku.trade api