diff --git a/docs/README.md b/docs/README.md
index 3ac4a1f554..5f6c5c87a8 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -46,6 +46,12 @@ along with this program.  If not, see [<https://www.gnu.org/licenses/>](https://
 
 Mostly documentation can be found on the Jamulus Website: https://jamulus.io
 
+## In this directory
+
+1. [JAMULUS_PROTOCOL.md](JAMULUS_PROTOCOL.md): how clients, servers and directories talk to each other
+2. [JSON-RPC.md](JSON-RPC.md): the JSON-RPC API — generated by `tools/generate_json_rpc_docs.py`, do not edit by hand
+3. [TRANSLATING.md](TRANSLATING.md): guide for translators
+
 ## Project related documentation
 
 1. Release process: https://jamulus.io/contribute/Release-Process