diff --git a/docs/hsi.md b/docs/hsi.md
index 9db61b3c2..4222e098e 100644
--- a/docs/hsi.md
+++ b/docs/hsi.md
@@ -1,5 +1,5 @@
-# Host Security ID Specification
-
+---
+title: Host Security ID Specification
 ---
 
 **WARNING:
diff --git a/docs/tutorial.md b/docs/tutorial.md
index 3e9bb25e1..947f3c9e6 100644
--- a/docs/tutorial.md
+++ b/docs/tutorial.md
@@ -1,4 +1,6 @@
-# Title: fwupd Plugin Tutorial
+---
+title: Plugin Tutorial
+---
 
 ## Introduction
 
diff --git a/subprojects/gi-docgen.wrap b/subprojects/gi-docgen.wrap
index 1abf7d5a2..713d4db49 100644
--- a/subprojects/gi-docgen.wrap
+++ b/subprojects/gi-docgen.wrap
@@ -1,5 +1,5 @@
 [wrap-git]
 directory=gi-docgen
 url=https://gitlab.gnome.org/GNOME/gi-docgen.git
-revision=2021.6
+revision=2021.7
 depth=1