diff --git a/cogl/cogl-vertex-buffer.h b/cogl/cogl-vertex-buffer.h
index 758534898..6184257bc 100644
--- a/cogl/cogl-vertex-buffer.h
+++ b/cogl/cogl-vertex-buffer.h
@@ -421,27 +421,20 @@ cogl_vertex_buffer_unref (CoglHandle handle) G_GNUC_DEPRECATED;
  *
  * 0, 1, 2, 0, 2, 3, 4, 5, 6, 4, 6, 7 ... etc
  *
- * For example, if you submit vertices for a quad like this:
+ * For example, if you submit vertices for a quad like like that shown
+ * in <xref linkend="quad-indices-order"/> then you can request 6
+ * indices to render two triangles like those shown in <xref
+ * linkend="quad-indices-triangles"/>.
  *
- * |[
- *    0        3
- *     ########
- *     #      #
- *     #      #
- *     ########
- *    1        2
- * ]|
+ * <figure id="quad-indices-order">
+ *   <title>Example of vertices submitted to form a quad</title>
+ *   <graphic fileref="quad-indices-order.png" format="PNG"/>
+ * </figure>
  *
- * Then you can request 6 indices to render two triangles like this:
- *
- * |[
- *    0           0        3
- *     ##          ########
- *     # ##          ##   #
- *     #   ##          ## #
- *     ########          ##
- *    1        2           2
- * ]|
+ * <figure id="quad-indices-triangles">
+ *   <title>Illustration of the triangle indices that will be generated</title>
+ *   <graphic fileref="quad-indices-triangles.png" format="PNG"/>
+ * </figure>
  *
  * Returns: A %CoglHandle containing the indices. The handled is
  * owned by Cogl and should not be modified or unref'd.
diff --git a/doc/reference/cogl/Makefile.am b/doc/reference/cogl/Makefile.am
index 8ca7830d9..74d96eacf 100644
--- a/doc/reference/cogl/Makefile.am
+++ b/doc/reference/cogl/Makefile.am
@@ -94,6 +94,8 @@ EXTRA_HFILES=
 HTML_IMAGES = \
 	fill-rule-non-zero.png \
 	fill-rule-even-odd.png \
+	quad-indices-order.png \
+	quad-indices-triangles.png \
 	cogl_ortho.png
 
 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
@@ -125,4 +127,6 @@ include $(top_srcdir)/gtk-doc.make
 EXTRA_DIST += \
 	fill-rule-non-zero.png \
 	fill-rule-even-odd.png \
+	quad-indices-triangles.png \
+	quad-indices-order.png \
 	cogl_ortho.png
diff --git a/doc/reference/cogl/quad-indices-order.png b/doc/reference/cogl/quad-indices-order.png
new file mode 100644
index 000000000..a31d95d48
Binary files /dev/null and b/doc/reference/cogl/quad-indices-order.png differ
diff --git a/doc/reference/cogl/quad-indices-triangles.png b/doc/reference/cogl/quad-indices-triangles.png
new file mode 100644
index 000000000..18c42c845
Binary files /dev/null and b/doc/reference/cogl/quad-indices-triangles.png differ