diff --git a/docs/libnm/Makefile.am b/docs/libnm/Makefile.am
index c5f2b836ba..7aa9810e81 100644
--- a/docs/libnm/Makefile.am
+++ b/docs/libnm/Makefile.am
@@ -1,6 +1,8 @@
 ## Process this file with automake to produce Makefile.in
 AUTOMAKE_OPTIONS = 1.6
 
+check_local =
+
 # The name of the module
 DOC_MODULE=libnm
 
@@ -94,3 +96,13 @@ CLEANFILES += \
 	tmpl/* \
 	xml/*
 
+if GTK_DOC_BUILD_HTML
+check-local-gtk-doc-patch:
+	@if grep -q -F '<a href="libnm-nm-setting-user.html">nm-setting-user</a>' "$(top_builddir)/docs/libnm/html/index.html"; then \
+		echo "WARNING: The generated documentation has issues. Patch your gtk-doc (see https://gitlab.gnome.org/GNOME/gtk-doc/merge_requests/2). Let this check fail with NMTST_CHECK_GTK_DOC=1"; \
+		test "$$NMTST_CHECK_GTK_DOC" != 1; \
+	fi
+check_local += check-local-gtk-doc-patch
+endif
+
+check-local: $(check_local)