Convert meas_base to numpydoc format.
Rationalize introductory documentation in meas_base
Please make warnings for broken :lsst-task: links optional
“Hidden” class confuses Sphinx automod.
pex_config numpydoc conversion and package documentation configuration
Reviews and consulting for numpydoc conversion work
David Staker [X], what's your current status with this ticket? Would you like me to take another look at all or specific parts? Is it ready to go?
Hey Jonathan — I spoke to David about this yesterday, actually. He's done a bunch of work across a number of packages which he hasn't got around to pushing yet; I think that includes these, and I hope we'll see an update within a couple of days.
Splitting this ticket. DM-15347 will only handle meas_base; use DM-16824 for meas_algorithms.
A few things to note here:
in module lsst.meas.base, but they were not present. Ignoring}}. These are due to DM-15461. They're fundamentally harmless, and addressing them would involve either significant work on the Sphinx infrastructure or significant rewriting of the meas_base code. Again, I propose to rule them out of scope for this ticket.
Russell Owen — thank you for agreeing to take a look at this! Please see the comment above for a little background.
PR is here: https://github.com/lsst/meas_base/pull/130
I've confirmed that this builds and passes tests.
Overall looks good. A few requests on github.
Thank you for the speedy turnaround!
I propose to go ahead and merge this after I've addressed Russell's requests. That'll mean generating a lot of warnings until DM-11558 merges, but I think that's something we can live with. Jonathan Sick, Russell Owen – please let me know if you're not happy with that.
Merged & done.