diff --git a/ges/ges-audio-source.c b/ges/ges-audio-source.c
index 8997107dae..03ee44c54d 100644
--- a/ges/ges-audio-source.c
+++ b/ges/ges-audio-source.c
@@ -28,25 +28,9 @@
* You can use the following children properties through the
* #ges_track_element_set_child_property and alike set of methods:
*
- *
- *
- *
- *
- *
- *
- *
- * double
- * volume
- * volume factor, 1.0=100%.
- *
- *
- * gboolean
- * mute
- * mute channel.
- *
- *
- *
- *
+ * - #gdouble `volume`: volume factor, 1.0=100%.
+ * - #gboolean `mute`: mute channel.
+ *
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
diff --git a/ges/ges-title-source.c b/ges/ges-title-source.c
index f67115bb82..239780eae5 100644
--- a/ges/ges-title-source.c
+++ b/ges/ges-title-source.c
@@ -29,63 +29,18 @@
* ## Children Properties
*
* You can use the following children properties through the
- * #ges_track_element_set_child_property and alike set of methods:
- *
- *
- *
- *
- *
- *
- *
- * guint
- * background
- * The color of the background
- *
- *
- * guint
- * color
- * The color of the text
- *
- *
- * gchar
- * font-desc
- * Pango font description string
- *
- *
- * GESTextHAlign
- * halignment
- * Horizontal alignment of the text
- *
- *
- * gchar
- * text
- * The text to be rendered
- *
- *
- * GESTextVAlign
- * valignment
- * Vertical alignent of the text
- *
- *
- * gdouble
- * xpos
- * The horizontal position of the text
- *
- * gdouble
- * ypos
- * The vertical position of the text
- *
- * gboolean
- * shaded-background
- * Whether to shade the background under the text area
- *
- * guint
- * outline-color
- * Color to use for outline the text (big-endian ARGB).
- *
- *
- *
- *
+ * #ges_timeline_element_set_child_property and alike set of methods:
+ *
+ * - #gchar `text`: The text to be rendered
+ * - #guint `background`: The color of the background
+ * - #guint `color`: The color of the text
+ * - #gchar `font-desc`: Pango font description string
+ * - #GESTextHAlign `halignment`: Horizontal alignment of the text
+ * - #GESTextVAlign `valignment`: Vertical alignent of the text
+ * - #gdouble `xpos`: The horizontal position of the text
+ * - #gdouble `ypos`: The vertical position of the text
+ * - #gboolean `shaded-background`: Whether to shade the background under the text area
+ * - #guint `outline-color`: Color to use for outline the text (big-endian ARGB).
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
diff --git a/ges/ges-types.h b/ges/ges-types.h
index 4a66d1fdfd..6d6f4684c1 100644
--- a/ges/ges-types.h
+++ b/ges/ges-types.h
@@ -26,10 +26,14 @@
G_BEGIN_DECLS
-/* Padding */
+/**
+ * GES_PADDING: (attributes doc.skip=true)
+ */
#define GES_PADDING 4
-/* padding for very extensible base classes */
+/**
+ * GES_PADDING_LARGE: (attributes doc.skip=true)
+ */
#define GES_PADDING_LARGE 20
/* Type definitions */
diff --git a/ges/ges-video-source.c b/ges/ges-video-source.c
index d8b4a4ad2d..94f7c6090f 100644
--- a/ges/ges-video-source.c
+++ b/ges/ges-video-source.c
@@ -23,64 +23,22 @@
* @title: GESVideoSource
* @short_description: Base Class for video sources
*
- * # Children Properties:
+ * ## Children Properties:
+ *
* You can use the following children properties through the
* #ges_track_element_set_child_property and alike set of methods:
- *
- *
- *
- *
- *
- *
- *
- *
- * double
- * alpha
- * The desired alpha for the stream.
- *
- *
- * gint
- * posx
- * The desired x position for the stream.
- *
- *
- * gint
- * posy
- * The desired y position for the stream
- *
- *
- * gint
- * width
- * The desired width for that source. Set to 0 if size is not mandatory, will be set to width of the current track.
- *
- *
- * gint
- * height
- * The desired height for that source. Set to 0 if size is not mandatory, will be set to height of the current track.
- *
- *
- * GstDeinterlaceModes
- * deinterlace-mode
- * Deinterlace Mode
- *
- *
- * GstDeinterlaceFields
- * deinterlace-fields
- * Fields to use for deinterlacing
- *
- *
- * GstDeinterlaceFieldLayout
- * deinterlace-tff
- * Deinterlace top field first
- *
- *
- * GstVideoOrientationMethod
- * video-direction
- * The desired video rotation and flipping.
- *
- *
- *
- *
+ *
+ * - #gdouble `alpha`: The desired alpha for the stream.
+ * - #gint `posx`: The desired x position for the stream.
+ * - #gint `posy`: The desired y position for the stream
+ * - #gint `width`: The desired width for that source.
+ * Set to 0 if size is not mandatory, will be set to width of the current track.
+ * - #gint `height`: The desired height for that source.
+ * Set to 0 if size is not mandatory, will be set to height of the current track.
+ * - #GstDeinterlaceModes `deinterlace-mode`: Deinterlace Mode
+ * - #GstDeinterlaceFields `deinterlace-fields`: Fields to use for deinterlacing
+ * - #GstDeinterlaceFieldLayout `deinterlace-tff`: Deinterlace top field first
+ * - #GstVideoOrientationMethod `video-direction`: The desired video rotation and flipping.
*/
#ifdef HAVE_CONFIG_H
#include "config.h"