diff --git a/doc-src/ssl.html b/doc-src/ssl.html
index d8ec3d4e2..de45bd29f 100644
--- a/doc-src/ssl.html
+++ b/doc-src/ssl.html
@@ -72,8 +72,12 @@ For example, you can generate a certificate in this format using these instructi
 
 Using a client side certificate
 ------------------------------------
-You can use a client side certificate file by specifying the directory in which the certificate is present after this argument, "--client-certs". The certificate file should be in .pem format after the url of the website whose certificate you've specified. Suppose, for example you want to open mitmproxy.com with a client side certificate, your certificate file's name should be like "mitmproxy.com.pem".
- 
+You can use a client certificate by passing the <kbd>--client-certs DIRECTORY</kbd> option to mitmproxy.
+If you visit example.org, mitmproxy looks for a file named example.org.pem in the specified directory
+and uses this as the client cert. The certificate file needs to be in the PEM format and should contain
+both the unencrypted private key as well as the certificate.
+
+
 Using a custom certificate authority
 ------------------------------------