clarified documentation regarding shear conventions