diff --git a/doc/examples/ddns/comments.json b/doc/examples/ddns/comments.json
index c6e7ee889e..3868ac69aa 100644
--- a/doc/examples/ddns/comments.json
+++ b/doc/examples/ddns/comments.json
@@ -1,6 +1,6 @@
 // This is an example configuration file for D2, Kea's DHCP-DDNS processor.
-// It uses embedded (i.e., which will be included in configuration objects
-// and not stripped by at lexical analysis) comments.
+// It uses embedded comments which will be included in configuration objects
+// within user-contexts rather than stripped away by at lexical analysis.
 
 {
 "DhcpDdns":