Jonathan Sick Thanks for agreeing to take look even after the holiday break weeks have officially started.

The PR is here: https://github.com/lsst/pipelines_lsst_io/pull/195
And my local build is here: https://lsst.ncsa.illinois.edu/~yusra/23.0.0/releases/v23_0_0.html#release-latest

I plan to cherry-pick the commit on to master when I merge this as well. Or I can merge to master and cherry-pick onto the release branch. Don't care.

I've got my review done; some of the suggestions are less important but I hope the suggestions are useful.

Thanks for also managing the cherry-picking back to the main branch. Let me know when the doc build for the release is done and I'll switch the main edition to show it at pipelines.lsst.io.

Thank you! Thank you!

Thanks for all the suggestions. I added spaces after all the headings, backslashes before underscored (that I could see), removed all the :codes: and took all your suggested edits except for one. See DM-33028. I don't know hack around the fact that those internal links won't exist in 23.0.0. They do on main, so I'll internally link on that commit. They will exist in 23.0.1, and will do DM-33028 on v23.0.x as soon as the docs for 23.0.0 are done.

I think this is ready to merge to v23.0.x. The merge to main will have to be later tonight.

Let me know if we're ready to release the docs; I haven't quite been able to keep up with where we're at. Cheers.