diff --git a/docs/_rpc/ns-eth.md b/docs/_rpc/ns-eth.md
index 94af3c817a..47b0dba5ad 100644
--- a/docs/_rpc/ns-eth.md
+++ b/docs/_rpc/ns-eth.md
@@ -7,6 +7,10 @@ Geth provides several extensions to the standard "eth" JSON-RPC namespace.
 * TOC
 {:toc}
 
+### eth_subscribe, eth_unsubscribe
+
+These methods are used for real-time events through subscriptions. See the [subscription
+documentation](./pubsub) for more information.
 
 ### eth_call
 
diff --git a/docs/_rpc/pubsub.md b/docs/_rpc/pubsub.md
index cb7015db1c..b4f24aacc8 100644
--- a/docs/_rpc/pubsub.md
+++ b/docs/_rpc/pubsub.md
@@ -1,5 +1,5 @@
 ---
-title: eth_subscribe
+title: Real-time Events
 ---
 
 Geth v1.4 and later support publish / subscribe using JSON-RPC notifications. This allows