From 07a25ec290a2d2054527d4fd53b64ed0687f1dcf Mon Sep 17 00:00:00 2001
From: jan <jan@orange.mpxd.net>
Date: Mon, 16 Feb 2026 18:53:31 -0800
Subject: [PATCH] [Mirrorable / Flippable] clarify docs

---
 masque/traits/mirrorable.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/masque/traits/mirrorable.py b/masque/traits/mirrorable.py
index deddddd..ac00147 100644
--- a/masque/traits/mirrorable.py
+++ b/masque/traits/mirrorable.py
@@ -25,8 +25,9 @@ class Mirrorable(metaclass=ABCMeta):
         to (0, 0), this is equivalent to mirroring in the container's coordinate system.
 
         Args:
-            axis: Axis to mirror across (0: x-axis, 1: y-axis).
-
+            axis: Axis to mirror across:
+                0: X-axis (flip y coords),
+                1: Y-axis (flip x coords)
         Returns:
             self
         """
@@ -37,8 +38,8 @@ class Mirrorable(metaclass=ABCMeta):
         Optionally mirror the entity across both axes through its origin.
 
         Args:
-            across_x: Mirror across x axis (flip y)
-            across_y: Mirror across y axis (flip x)
+            across_x: Mirror across the horizontal X-axis (flip Y coordinates).
+            across_y: Mirror across the vertical Y-axis (flip X coordinates).
 
         Returns:
             self
@@ -81,7 +82,7 @@ class Flippable(Positionable, metaclass=ABCMeta):
         into account.
 
         Args:
-            axis: Axis to mirror across. 0 mirrors across y=0. 1 mirrors across x=0.
+            axis: Axis to mirror across. 0: x-axis (flip y coord), 1: y-axis (flip x coord).
             x: Vertical line x=val to mirror across.
             y: Horizontal line y=val to mirror across.