diff --git a/README.md b/README.md
index 5183fcb..b64d0ee 100644
--- a/README.md
+++ b/README.md
@@ -117,7 +117,10 @@ Transform a video in one size to another size using black letterboxes on the sid
 Split an audio file according to silence
 
 # Complex Example
-Here is a complex example using multiple assets and operations:
+Here is a complex example using multiple assets and operations.
+
+Note that in JVCL json files, comments are allowed using either line syntax (`// comment`)
+or multi-line block syntax (`/* comment that may span multiple lines */`).
 
 ```json
 {