diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index a2e8c02042..dedc4d8770 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -74,17 +74,18 @@
  *
  * |[<!-- language="plain" -->
  * frame 
- * ├── border
+ * ├── border[.flat]
  * ├── <label widget>
  * ╰── <child>
  * ]|
  *
- * GtkFrame has a main CSS node with name frame and a subnode with
- * name border. The border node is used to render the visible border.
+ * GtkFrame has a main CSS node named “frame” and a subnode named “border”. The
+ * “border” node is used to draw the visible border. You can set the appearance
+ * of the border using CSS properties like “border-style” on the “border” node.
  *
- * The border node can be given the style class .flat, which is used by themes
+ * The border node can be given the style class “.flat”, which is used by themes
  * to disable drawing of the border. To do this from code, call
- * gtk_frame_set_shadow_type() with %GTK_SHADOW_NONE to add the .flat class or
+ * gtk_frame_set_shadow_type() with %GTK_SHADOW_NONE to add the “.flat” class or
  * any other shadow type to remove it.
  */