diff --git a/config-example.yaml b/config-example.yaml
index f28b4191..d4aa7815 100644
--- a/config-example.yaml
+++ b/config-example.yaml
@@ -66,10 +66,16 @@ dns_config:
   base_domain: example.com
 
 
-# Experimental: OpenID Connect
+# headscale supports experimental OpenID connect support, 
+# it is still being tested and might have some bugs, please
+# help us test it.
+# OpenID Connect
 # oidc:
 #   issuer: "https://your-oidc.issuer.com/path"
 #   client_id: "your-oidc-client-id"
 #   client_secret: "your-oidc-client-secret"
+#
+#   # Domain map is used to map incomming users (by their email) to 
+#   # a namespace. The key can be a string, or regex.
 #   domain_map:
 #     ".*": default-namespace