Building pipelines.lsst.io with the Stack
These steps allow you to reproduce a pipelines.lsst.io build integrated with Stack packages.
The usual lsstsw-based build
git clone https://github.com/lsst/lsstsw.git
rebuild verify pipe_base
# eups tags --clone bNNNN current
I'm only building verify and pipe_base because those are packages that have new-style package documentation.
Clone and install pipelines_lsst_io dependencies
git clone https://github.com/lsst/pipelines_lsst_io
git checkout tickets/DM-11216
pip install -r requirements.txt
DM-11216 branch is just the integration branch I'm using here. Ultimately we'd want to use lsstsw to clone the appropriate branch of pipelines_lsst_io for the requested set of Git refs.
Can/should we make pipelines_lsst_io something that clone-able and install-able by lsstsw?
Setup the EUPS dependencies of pipelines_lsst_io
pipelines_lsst_io has a ups/pipelines_lsst_io.table file that declares what packages it includes in its build.
Build the integrated documentation
The built HTML is in the _build/html/ directory of the cloned pipelines_lsst_io repo.
The build-stack-docs tool symlinks the doc/ directories of setup EUPS packages into the pipelines_lsst_io repository. Then it runs Sphinx once over all the content (both from pipelines_lsst_io and individual packages).
Next, we'd run a tool like ltd-mason (or really something new from github.com/lsst-sqre/ltd-conveyor) to upload the HTML to LSST the Docs.