Guiding user on how to detail aperture geometry

base_classes/NXaperture.nxdl.xml

@@ -26,6 +26,8 @@
       A beamline aperture.
 
       Note, the group was incorrectly documented as deprecated, but it is not and it is in common use.
+
+      You can specify the geometry of the aperture using either NXoff_geometry or for simpler geometry shape and size.
     </doc>
     <!--TODO compare with "screens" in SHADOW-->
     <field name="depends_on" type="NX_CHAR">
@@ -66,7 +68,7 @@
     </group>
     <group type="NXgeometry" deprecated="Use the field `depends_on` and :ref:`NXtransformations` to position the aperture and :ref:`NXoff_geometry` to describe its shape">
         <doc>
-            location and shape of aperture
+            Location and shape of aperture
 
             .. TODO: documentation needs improvement, contributions welcome