diff --git a/girs/GES-1.0.gir b/girs/GES-1.0.gir
index c205e43a93..6a192688c6 100644
--- a/girs/GES-1.0.gir
+++ b/girs/GES-1.0.gir
@@ -1664,7 +1664,8 @@ would not be able to adapt itself once the effect is added.</doc>
             <type name="BaseEffect" c:type="GESBaseEffect*"/>
           </parameter>
           <parameter name="index" transfer-ownership="none">
-            <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-clip.c">The index to add @effect at, or -1 to add at the highest</doc>
+            <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-clip.c">The index to add @effect at, or -1 to add at the highest,
+        see #ges_clip_get_top_effect_index for more information</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
diff --git a/subprojects/gst-editing-services/ges/ges-clip.c b/subprojects/gst-editing-services/ges/ges-clip.c
index 30478e2f24..457054b052 100644
--- a/subprojects/gst-editing-services/ges/ges-clip.c
+++ b/subprojects/gst-editing-services/ges/ges-clip.c
@@ -3034,7 +3034,8 @@ _cmp_children_by_priority (gconstpointer a_p, gconstpointer b_p)
  * ges_clip_add_top_effect:
  * @clip: A #GESClip
  * @effect: A top effect to add
- * @index: The index to add @effect at, or -1 to add at the highest
+ * @index: The index to add @effect at, or -1 to add at the highest,
+ *         see #ges_clip_get_top_effect_index for more information
  * @error: (nullable): Return location for an error
  *
  * Add a top effect to a clip at the given index.