diff --git a/gtk/gtkcenterlayout.c b/gtk/gtkcenterlayout.c
index c5264ddaf6..18bed9ddb9 100644
--- a/gtk/gtkcenterlayout.c
+++ b/gtk/gtkcenterlayout.c
@@ -27,13 +27,13 @@
 #include "gtkcssnodeprivate.h"
 
 /**
- * SECTION:gtkcenterlayout
- * @Title: GtkCenterLayout
- * @Short_description: A centering layout
+ * GtkCenterLayout:
  *
- * A #GtkCenterLayout is a layout manager that manages up to three children.
- * The start widget is allocated at the start of the layout (left in LRT
- * layouts and right in RTL ones), and the end widget at the end.
+ * `GtkCenterLayout` is a layout manager that manages up to three children.
+ *
+ * The start widget is allocated at the start of the layout (left in
+ * left-to-right locales and right in right-to-left ones), and the end
+ * widget at the end.
  *
  * The center widget is centered regarding the full width of the layout's.
  */
@@ -543,9 +543,9 @@ gtk_center_layout_init (GtkCenterLayout *self)
 /**
  * gtk_center_layout_new:
  *
- * Creates a new #GtkCenterLayout.
+ * Creates a new `GtkCenterLayout`.
  *
- * Returns: the newly created #GtkCenterLayout
+ * Returns: the newly created `GtkCenterLayout`
  */
 GtkLayoutManager *
 gtk_center_layout_new (void)
@@ -555,7 +555,7 @@ gtk_center_layout_new (void)
 
 /**
  * gtk_center_layout_set_orientation:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  * @orientation: the new orientation
  *
  * Sets the orientation of @self.
@@ -575,7 +575,7 @@ gtk_center_layout_set_orientation (GtkCenterLayout *self,
 
 /**
  * gtk_center_layout_get_orientation:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  *
  * Gets the current orienration of the layout manager.
  *
@@ -591,7 +591,7 @@ gtk_center_layout_get_orientation (GtkCenterLayout *self)
 
 /**
  * gtk_center_layout_set_baseline_position:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  * @baseline_position: the new baseline position
  *
  * Sets the new baseline position of @self
@@ -611,7 +611,7 @@ gtk_center_layout_set_baseline_position (GtkCenterLayout     *self,
 
 /**
  * gtk_center_layout_get_baseline_position:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  *
  * Returns the baseline position of the layout.
  *
@@ -627,7 +627,7 @@ gtk_center_layout_get_baseline_position (GtkCenterLayout *self)
 
 /**
  * gtk_center_layout_set_start_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  * @widget: (nullable): the new start widget
  *
  * Sets the new start widget of @self.
@@ -650,7 +650,7 @@ gtk_center_layout_set_start_widget (GtkCenterLayout *self,
 
 /**
  * gtk_center_layout_get_start_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  *
  * Returns the start widget fo the layout.
  *
@@ -666,7 +666,7 @@ gtk_center_layout_get_start_widget (GtkCenterLayout *self)
 
 /**
  * gtk_center_layout_set_center_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  * @widget: (nullable): the new center widget
  *
  * Sets the new center widget of @self.
@@ -689,7 +689,7 @@ gtk_center_layout_set_center_widget (GtkCenterLayout *self,
 
 /**
  * gtk_center_layout_get_center_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  *
  * Returns the center widget of the layout.
  *
@@ -705,7 +705,7 @@ gtk_center_layout_get_center_widget (GtkCenterLayout *self)
 
 /**
  * gtk_center_layout_set_end_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  * @widget: (nullable) (transfer none): the new end widget
  *
  * Sets the new end widget of @self.
@@ -728,7 +728,7 @@ gtk_center_layout_set_end_widget (GtkCenterLayout *self,
 
 /**
  * gtk_center_layout_get_end_widget:
- * @self: a #GtkCenterLayout
+ * @self: a `GtkCenterLayout`
  *
  * Returns the end widget of the layout.
  *