Details
-
Type:
Story
-
Status: Done
-
Resolution: Done
-
Fix Version/s: None
-
Component/s: Stack Documentation and UX
-
Labels:
-
Story Points:4.8
-
Epic Link:
-
Team:SQuaRE
Description
The pipelines.lsst.io build tool will coordinate builds of the pipelines.lsst.io Sphinx site. Its main functionality is:
- Symlink doc/ directories of packages into a pipelines.lsst.io clone
- Add configuration information (like the current tag, or if working on master, the branches and most recent tag)
- Run the Sphinx build
Some of this functionality is already coded in LTD Mason, however, it should be moved to https://github.com/lsst-sqre/documenteer, our core package for DM Sphinx projects. (I'm slowly breaking LTD Mason apart; I think having a single package that was both an LTD upload tool and a build tool was a wrong fit).
Attachments
Issue Links
Activity
| Field | Original Value | New Value |
|---|---|---|
| Epic Link |
|
| Description |
The pipelines.lsst.io build tool will coordinate builds of the pipelines.lsst.io Sphinx site. Its main functionality is:
- Symlink doc/ directories of packages into a pipelines.lsst.io clone - Add configuration information (like the current tag, or if working on master, the branches and most recent tag) - Run the Sphinx build Some of this functionality is already coded in LTD Mason, however, it should be moved https://github.com/lsst-sqre/documenteer, our core package for DM Sphinx projects. (I'm slowly breaking LTD Mason apart; I think having a single package that was both an LTD upload tool and a build tool was a wrong fit). |
The pipelines.lsst.io build tool will coordinate builds of the pipelines.lsst.io Sphinx site. Its main functionality is:
- Symlink doc/ directories of packages into a pipelines.lsst.io clone - Add configuration information (like the current tag, or if working on master, the branches and most recent tag) - Run the Sphinx build Some of this functionality is already coded in LTD Mason, however, it should be moved to https://github.com/lsst-sqre/documenteer, our core package for DM Sphinx projects. (I'm slowly breaking LTD Mason apart; I think having a single package that was both an LTD upload tool and a build tool was a wrong fit). |
| Status | To Do [ 10001 ] | In Progress [ 3 ] |
| Story Points | 2.5 |
| Story Points | 2.5 | 2.7 |
| Story Points | 2.7 | 3.1 |
| Story Points | 3.1 | 4.3 |
| Reviewers | Simon Krughoff [ krughoff ] | |
| Status | In Progress [ 3 ] | In Review [ 10004 ] |
| Status | In Review [ 10004 ] | Reviewed [ 10101 ] |
| Story Points | 4.3 | 4.8 |
| Labels | documenteer pipelines-docs |
| Resolution | Done [ 10000 ] | |
| Status | Reviewed [ 10101 ] | Done [ 10002 ] |