diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index 4374f1f5bc..ba3164296a 100644
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -39,6 +39,10 @@
  * <link linkend="gtk-assistant-set-page-complete">completion</link> and
  * <link linkend="gtk-assistant-commit">committed</link> status.
  *
+ * If you have a case that doesn't quite fit in #GtkAssistants way of
+ * handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page type
+ * and handle buttons yourself.
+ *
  * <refsect2 id="GtkAssistant-BUILDER-UI">
  * <title>GtkAssistant as GtkBuildable</title>
  * <para>