improvements to docstring on Repair() method