diff --git a/compact/definitions.xml b/compact/definitions.xml
index c852f768a0655f4e4af31ae80824b56b0659acba..417fe0e1998bef01eacea7307b2b3662de2b4404 100644
--- a/compact/definitions.xml
+++ b/compact/definitions.xml
@@ -346,6 +346,8 @@ Examples:
     <documentation>
       ### Tracker Detector Parameters
       TrackerBarrel_rmax: also the rmin for the barrel PID system (DIRC)
+      Note: The barrel rmax and endcap lengths are the maximum extent allowed for
+      the barrel and endcap layers, not the position of the final layer.
     </documentation>
 
     <constant name="TrackerBarrel_rmin"         value="VertexTrackingRegion_rmax"/>