Yes, I agree.  I simplified those docstrings considerably and used the reference to getShear.  After some thought, I decided to do the same for getLensing, just because it has always been a pain to keep the docstrings for getShear and getLensing in sync, and it seems fair enough to refer to getShear for all the 'get' methods.