Add descriptions to state_keys. Add it into the template.

templating/internal/units.py

@@ -100,6 +100,7 @@ def _load_schemas():
             json_schema = json.loads(f.read())
             schema = {
                 "typeof": None,
+                "typeof_info": "",
                 "type": None,
                 "title": None,
                 "desc": None,
@@ -116,7 +117,7 @@ def _load_schemas():
 
             # add typeof
             base_defs = {
-                "core#/definitions/room_event": "Room Event",
+                "core#/definitions/room_event": "Message Event",
                 "core#/definitions/state_event": "State Event"
             }
             if type(json_schema.get("allOf")) == list:
@@ -136,6 +137,13 @@ def _load_schemas():
                 prop(json_schema, "properties/content")
             )
 
+            # Assign state key info
+            if schema["typeof"] == "State Event":
+                skey_desc = prop(json_schema, "properties/state_key/description")
+                if not skey_desc:
+                    raise Exception("Missing description for state_key")
+                schema["typeof_info"] = "``state_key``: %s" % skey_desc
+
             schemata[filename] = schema
     return schemata
 

templating/templates/events.tmpl

@@ -1,6 +1,9 @@
 ``{{event.type}}``
 {{(4 + event.type | length) * '-'}}
-{{event.desc | wrap(80)}}
+*{{event.typeof}}*
+  {{event.typeof_info}}
+
+  {{event.desc | wrap(80) | indent_block(2)}}
 {% for table in event.content_fields -%}
 {{"``"+table.title+"``" if table.title else ""}}