From 1396ae4d6687af3a09f86a7c9a5f98c081896cd1 Mon Sep 17 00:00:00 2001
From: Jany Belluz <jany.belluz@daltonmaag.com>
Date: Tue, 18 Oct 2022 17:27:19 +0100
Subject: [PATCH] [designspaceLib] Document XML field <labels ordering="1">

---
 Doc/source/designspaceLib/xml.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Doc/source/designspaceLib/xml.rst b/Doc/source/designspaceLib/xml.rst
index 6267b0255..a8dde8437 100644
--- a/Doc/source/designspaceLib/xml.rst
+++ b/Doc/source/designspaceLib/xml.rst
@@ -162,10 +162,17 @@ For a discrete axis:
 ``<labels>`` element (axis)
 ---------------------------
 
-The ``<labels>`` element contains one or more ``<label>`` elements.
+The ``<labels>`` element contains one or more ``<label>`` elements, and can
+indicate this axis' STAT ordering.
 
 .. versionadded:: 5.0
 
+.. rubric:: Attributes
+
+- ``ordering``: optional, int, default: natural position of this axis in the list
+  of axes. STAT table field ``axisOrdering`` for this axis.
+
+  See: `OTSpec STAT Axis Record <https://docs.microsoft.com/en-us/typography/opentype/spec/stat#axis-records>`_
 
 ``<label>`` element (axis)
 ..........................