diff --git a/examples/caddy/matrix-riot-web b/examples/caddy/matrix-riot-web
index 28df6cd29..8c1957257 100644
--- a/examples/caddy/matrix-riot-web
+++ b/examples/caddy/matrix-riot-web
@@ -1,4 +1,5 @@
 https://riot.DOMAIN {
+	# These might differ if you are supplying your own certificates
 	tls /matrix/ssl/config/live/riot.DOMAIN/fullchain.pem /matrix/ssl/config/live/riot.DOMAIN/privkey.pem
 
 	proxy / http://127.0.0.1:8765 {
diff --git a/examples/caddy/matrix-synapse b/examples/caddy/matrix-synapse
index 800d7f7b8..8cb9805a2 100644
--- a/examples/caddy/matrix-synapse
+++ b/examples/caddy/matrix-synapse
@@ -1,4 +1,5 @@
 https://matrix.DOMAIN {
+	# If you use your own certificates, your path may differ
 	tls /matrix/ssl/config/live/matrix.DOMAIN/fullchain.pem /matrix/ssl/config/live/matrix.DOMAIN/privkey.pem
 
 	root /matrix/static-files
@@ -10,14 +11,15 @@ https://matrix.DOMAIN {
 		X-XSS-Protection "1; mode=block"
 	}
 
+	# Identity server traffic
 	proxy /_matrix/identity matrix-msisd:8090 {
 		transparent
 	}
-
 	proxy /_matrix/client/r0/user_directory/search matrix-msisd:8090 {
 		transparent
 	}
 
+	# Synapse Client<>Server API
 	proxy / matrix-synapse:8008 {
 		transparent
 		without /.well-known/ /_matrix/identity/ /_matrix/client/r0/user_directory/search