Is there a top-level page where all the tasks on pipelines.lsst.io are listed? It wouldn't be obvious to me to look under lsst.meas.astrom for Task documentation, unless I remembered the twisted history of which task was written when.
Yes, the original plan calls for curating the task listings around processing contexts (https://dmtn-030.lsst.io/#processing-section). Having an uncurated index page to all tasks, though, sounds pretty useful. John Swinbank's suggestion should work for that. That's a different ticket, than this one, though, right? I've created
DM-20850 to go ahead and implement that.
It's really unfortunate that task documentation is now split across two locations.
You can improve this by directing more resources to writing task documentation We're all in this together; documentation doesn't just happen.
Also, when I wrote up the port of the task documentation to Sphinx I was directed by Frossie Economou not to spend a lot of time on lsstDebug-related docs because it seems a risk of imminent deprecation (reiterated in https://dmtn-085.lsst.io), so not worth the effort. That's why the template speaks so briefly about debug variables. You might want to move quickly on deciding what to do about lsstDebug so we know definitely whether to put effort into it or not.