Thanks for doing this! I had to time box the review because obviously there's a lot to cover, and a number of things can be refined with further iterative development. I hope that the comments I have provided are at least educational and can frame future work.
In general, an easy win is to ensure that all the descriptions are sentences (capitalized and ending with a period).
I also noticed that there are references to DipoleFitAlgorithm, but that class isn't part of the public API documentation. You might want to look into either making that API public in `lsst.ip.diffim` or adding another `automodapi` directive that points to the module where DipoleFitAlgorithm is located (choose whichever is appropriate).