2 files changed, 5 insertions, 5 deletions

diff --git a/design-notes.md b/design-notes.md
index c39f98c..9bcbeb5 100644
--- a/design-notes.md
+++ b/design-notes.md
@@ -119,7 +119,7 @@ Serialised item structure:
 
 ```json
 {
-  /* common fields */
+  "_comment": "common fields",
 
   "title": "Some title",
   "date": "2019-12-20T16:51:52+00:00",
@@ -135,7 +135,7 @@ Serialised item structure:
   "thumbnail": { "path": "[resource path]" },
 
 
-  /* type-dependent */
+  "_comment": "type-dependent",
 
   "properties": {
     "type": "image",
@@ -150,7 +150,7 @@ Serialised item structure:
 
   "properties": {
     "type": "directory",
-    "items": [ /* item objects */ ]
+    "items": [ { "_comment": "item objects..." } ]
   }
 }
 ```
diff --git a/example/index.json b/example/index.json
index eef35c7..c7d75e6 100644
--- a/example/index.json
+++ b/example/index.json
@@ -1,6 +1,6 @@
-/* reference gallery index file, manually aggregated */
-
 {
+  "_comment": "reference gallery index file, manually aggregated",
+
   "title": "",
   "date": "",
   "description": "",