Jonathan Sick added a comment - 08/Feb/18 4:03 PM - edited 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 cd lsstsw ./bin/deploy source bin/setup.sh 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 cd .. git clone https://github.com/lsst/pipelines_lsst_io cd pipelines_lsst_io git pull git checkout tickets/DM-11216 pip install -r requirements.txt The tickets/ 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 setup -r . pipelines_lsst_io has a ups/pipelines_lsst_io.table file that declares what packages it includes in its build. Build the integrated documentation build-stack-docs -d . 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.

Jonathan Sick added a comment - 25/May/18 3:06 PM In the linked community post , I've figured out how to install the documenteer tooling in an isolated Python virtual environment. This is great because it lets developers locally install and use documenteer without affecting their stack.

Jonathan Sick added a comment - 21/Aug/18 10:32 AM At long last, it's time to ship the new pipelines.lsst.io documentation system. PR for pipelines_lsst_io itself:  https://github.com/lsst/pipelines_lsst_io/pull/99 PR for the Jenkins job:  https://github.com/lsst-sqre/jenkins-dm-jobs/pull/479

Simon Krughoff added a comment - 21/Aug/18 4:51 PM These changes look great. I'm assuming you don't need me to also review the documenteer changes that enable this.

Simon Krughoff added a comment - 21/Aug/18 4:53 PM I see there is also a branch for this ticket in verify_metrics . Is that something I should look at?

Jonathan Sick added a comment - 22/Aug/18 12:06 PM Thanks Simon Krughoff , this is good. The Documenteer stuff was all on separate tickets anyhow. I completely forgot I also had the prototyping branch with verify_metrics . I'll take a look and see if that needs to be updated.

Jonathan Sick added a comment - 22/Aug/18 12:12 PM It looks like this ticket branch in verify_metrics got superseded by other work that added a documentation directory, so there's no need to merge tickets/ DM-11216 in verify_metrics .