diff --git a/examples/vars.yml b/examples/vars.yml
index ed2c84b21..d4d8066f8 100644
--- a/examples/vars.yml
+++ b/examples/vars.yml
@@ -12,7 +12,7 @@ matrix_domain: example.com
 # The Matrix homeserver software to install.
 # See:
 #  - `roles/custom/matrix-base/defaults/main.yml` for valid options
-# - the `docs/configuring-playbook-IMPLEMENTATION_NAME.md` documentation page, if one is available for your implementation choice
+#  - the `docs/configuring-playbook-IMPLEMENTATION_NAME.md` documentation page, if one is available for your implementation choice
 #
 # By default, we use Synapse, because it's the only full-featured Matrix server at the moment.
 #
diff --git a/roles/custom/matrix-coturn/defaults/main.yml b/roles/custom/matrix-coturn/defaults/main.yml
index 1b5f1c507..bda15196a 100644
--- a/roles/custom/matrix-coturn/defaults/main.yml
+++ b/roles/custom/matrix-coturn/defaults/main.yml
@@ -85,7 +85,7 @@ matrix_coturn_turn_udp_max_port: 49172
 matrix_coturn_authentication_method: auth-secret
 
 # A shared secret used for authentication when `matrix_coturn_authentication_method` is `auth-secret`.
-# You can put any string here, but generating a strong one is preferred (e.g. `pwgen -s 64 1`).
+# You can put any string here, but generating a strong one is preferred. You can create one with a command like `pwgen -s 64 1`.
 matrix_coturn_turn_static_auth_secret: ""
 
 # A username used authentication when `matrix_coturn_authentication_method` is `lt-cred-mech`.