diff --git a/README.md b/README.md
index 13e32b52..cdffc11b 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,11 @@
This repository contains specifications for the peer-to-peer networking protocols used by
Ethereum.
+* The [Node Discovery Protocol] (version 4)
+* The [RLPx transport protocol] (version 5) and several RLPx-based capabilities:
+ * [Ethereum Wire Protocol] (version 63)
+ * [Light Ethereum Subprotocol] (version 2)
+
The issue tracker here is for discussions of protocol changes. It's OK to open an issue if
you just have a question. You can also get in touch through our [Gitter channel].
@@ -63,7 +68,10 @@ devp2p is part of most Ethereum clients. Implementations include:
WireShark dissectors are available here: https://github.com/ConsenSys/ethereum-dissectors
-
+[Node Discovery Protocol]: ./discv4.md
+[RLPx transport protocol]: ./RLPx.md
+[Ethereum Wire Protocol]: ./caps/eth.md
+[Light Ethereum Subprotocol]: ./caps/les.md
[Gitter channel]: https://gitter.im/ethereum/devp2p
[Ethereum Foundation Bounty Program]: https://bounty.ethereum.org
[libp2p]: https://libp2p.org
diff --git a/rlpx.md b/rlpx.md
index 359875d7..5bd5ce07 100644
--- a/rlpx.md
+++ b/rlpx.md
@@ -21,8 +21,8 @@ used in the RLPx handshake. The cryptosystem used by RLPx is
- `MAC(k, m)`: HMAC using the SHA-256 hash function.
- `AES(k, iv, m)`: the AES-128 encryption function in CTR mode.
-Alice wants to send an encrypted message that can be decrypted by Bobs static private key
-kB. Alice knows about Bobs static public key
+Alice wants to send an encrypted message that can be decrypted by Bob's static private key
+kB. Alice knows about Bob's static public key
KB.
To encrypt the message `m`, Alice generates a random number `r` and corresponding elliptic