diff --git a/info.yaml-format-info.md b/info.yaml-format-info.md
index d578ea0..bdf14c9 100644
--- a/info.yaml-format-info.md
+++ b/info.yaml-format-info.md
@@ -80,13 +80,13 @@ a list of strings like `[colour, niss, nisse]`. gallery views let you filter by
 
 ## desc & nsfw-desc {#desc}
 
-the full form of these fields is as a map from arbitrary headings to html contents. for example on a character info page it might start:
+the full form of these fields is as an ordered map from arbitrary headings to html contents. for example on a character info page it might start:
 
 ```
 desc:
-  name: niss
-  pronouns: she/her
-  height: 9 ft (275 cm)
+  - name: niss
+  - pronouns: she/her
+  - height: 9 ft (275 cm)
   # etc
 ```
 
@@ -99,8 +99,8 @@ either or both can also be just an html string, in which case they are put under
 desc: |
   blablabla
 desc:
-  about: |
-    blablabla
+  - about: |
+      blablabla
 ```
 
 ## images