diff --git a/ges/ges-audio-source.c b/ges/ges-audio-source.c
index b9fe562410..c5a97cc8cb 100644
--- a/ges/ges-audio-source.c
+++ b/ges/ges-audio-source.c
@@ -23,10 +23,11 @@
  * @title: GESAudioSource
  * @short_description: Base Class for audio sources
  *
- * <refsect1 id="GESVideoSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties
+ * ## Children Properties
+ *
  * You can use the following children properties through the
  * #ges_track_element_set_child_property and alike set of methods:
+ *
  * <informaltable frame="none">
  * <tgroup cols="3">
  * <colspec colname="properties_type" colwidth="150px"/>
@@ -46,7 +47,6 @@
  * </tbody>
  * </tgroup>
  * </informaltable>
- * </refsect1>
  */
 
 #include "ges-internal.h"
diff --git a/ges/ges-title-source.c b/ges/ges-title-source.c
index 6a294b582a..af39152e23 100644
--- a/ges/ges-title-source.c
+++ b/ges/ges-title-source.c
@@ -26,8 +26,8 @@
  * #GESTitleSource is a GESTimelineElement that implements the notion
  * of titles in GES.
  *
- * <refsect1 id="GESTileSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties
+ * ## Children Properties
+ *
  * You can use the following children properties through the
  * #ges_track_element_set_child_property and alike set of methods:
  * <informaltable frame="none">
@@ -86,7 +86,6 @@
  * </tbody>
  * </tgroup>
  * </informaltable>
- * </refsect1>
  */
 
 #include "ges-internal.h"
diff --git a/ges/ges-transition.c b/ges/ges-transition.c
index 82c159780c..d6d5652b40 100644
--- a/ges/ges-transition.c
+++ b/ges/ges-transition.c
@@ -17,6 +17,7 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+
 /**
  * SECTION:gestransition
  * @title: GESTransition
diff --git a/ges/ges-video-source.c b/ges/ges-video-source.c
index 87a917a61b..af1a34cee1 100644
--- a/ges/ges-video-source.c
+++ b/ges/ges-video-source.c
@@ -23,10 +23,10 @@
  * @title: GESVideoSource
  * @short_description: Base Class for video sources
  *
- * <refsect1 id="GESVideoSource.children_properties" role="properties">
- * # Children Properties
+ * # Children Properties:
  * You can use the following children properties through the
  * #ges_track_element_set_child_property and alike set of methods:
+ *
  * <informaltable frame="none">
  * <tgroup cols="3">
  * <colspec colname="properties_type" colwidth="150px"/>
@@ -81,7 +81,6 @@
  * </tbody>
  * </tgroup>
  * </informaltable>
- * </refsect1>
  */
 
 #include <gst/pbutils/missing-plugins.h>