diff --git a/doc/json_ui.asciidoc b/doc/json_ui.asciidoc
index 5a18d179..67ca3c27 100644
--- a/doc/json_ui.asciidoc
+++ b/doc/json_ui.asciidoc
@@ -1,9 +1,10 @@
 Json-Rpc user interface
 =======================
 
-Kakoune user interfaces can be implemented through the json-rpc 2.0 protocol.
+Kakoune user interfaces can be implemented through the
+https://www.jsonrpc.org/specification[json-rpc 2.0 protocol].
 
-By launching kakoune in client mode with the `-ui json` option, the launched
+By launching Kakoune in client mode with the `-ui json` option, the launched
 client will write newline separated json-rpc requests on stdout and read
 json-rpc requests on stdin.  Errors will be reported on stderr (not in
 json format).