clarified documentation regarding shear conventions
Merge branch 'master' into #376