diff --git a/platform.md b/platform.md
index e3e99d2e..1c902652 100644
--- a/platform.md
+++ b/platform.md
@@ -221,8 +221,10 @@ Where:
 type = "<source type>"
 
 [source.version]
+# arbitrary data describing version
 
 [source.metadata]
+# arbitrary data
 
 ```
 Where: