No, this comment is still correct.  The *observed* moments (i.e., no PSF correction) are represented using a Shear, it's the *corrected* shape that is no longer represented using a Shear.  However, I will try to make this clearer, and it's a good reminder that I should check over this documentation to see if any of it has become incorrect with all the recent changes to this code.  (I think I need to make a "checklist before making a pull request" to remind myself of all these things… soon to include the changelog as well!)