Add a task index page to pipelines.lsst.io

Description

Add a index page for every task in lsst_distrib to https://pipelines.lsst.io.

This is a simpler version of the process-context-based documentation sections designed in https://dmtn-030.lsst.io/#processing-section, but it's something that is doable now with little effort.

This index page could either be linked from the homepage, or from a Task framework page.

Checklist

Issue Matrix

hide

Lucidchart Diagrams

Activity

Show:

Jonathan Sick August 9, 2019 at 3:19 PM

Configurables are entities that came up in my research. They have ConfigClass attributes, but don't have run methods, so they're not technically tasks. They end up being values of config fields, which is why I ended up having to support them. I don't have an example off the top of my head. It may be that they won't get used in the future, in which case it'll be easy to drop that section in the future.

Yes, your intuition is right on why I went with an indices section rather than putting this page front and centre. Perhaps the time is right to just build out the structure of the Processing and Frameworks sections of the docs. After all, we can start populating these docs if we don't have the starting points.

I might prefer to do that after I finish integrating docs builds with scons and the stack-os-matrix job so that development is a bit more straightforward.

John Swinbank August 8, 2019 at 3:45 PM

Thanks, — this looks great.

I have a couple of general comments/questions, which I don't think should delay the merger of this ticket.

  • While I can see why you've put this in an “Indices” section, it feels a little bit buried. The tasks are really the algorithmic heart of the Pipelines, and I feel like we ought to be presenting them front-and-center in a “look at all the useful things you can do” kind of a way. In DMTN-030ese, I think that means this sort of listing should be linked from the “Processing” section. Since that section doesn't exist yet, there's obviously not much we can do about it for now!

  • I feel ignorant for asking this, but what should be listed by lsst-configurables? At the moment, it's showing nothing... and it's not obvious to me what it's for. I had a quick look at the Developer Guide and it didn't really help. What did I miss?

Jonathan Sick August 7, 2019 at 7:44 PM

what do you think about the Index/Task index pages added in this PR: https://github.com/lsst/pipelines_lsst_io/pull/138

Done
Pinned fields
Click on the next to a field label to start pinning.

Details

Assignee

Reporter

Reviewers

John Swinbank

Story Points

RubinTeam

SQuaRE

Components

Checklist

Created July 31, 2019 at 7:47 PM
Updated August 9, 2019 at 10:07 PM
Resolved August 9, 2019 at 10:07 PM