Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-13088

Bring LDM-294 current; fix document build

    Details

    • Type: Story
    • Status: Done
    • Resolution: Done
    • Fix Version/s: None
    • Component/s: Management
    • Labels:
    • Team:
      Architecture

      Description

      There is a considerable amount of work on the draft and DM-7501 branches for LDM-294 that has been quiescent since October. It includes updates to management staffing, e.g., Simon's move to Tucson.

      There is also a apparent shortcoming of the Makefile for the document that means that the productlist.csv file is not used automatically to create all the required new .tex files as part of the build. In particular, this affects the component/product table in Appendix A.

      Finally, at the same time we should switch to the new conventions for release of change-controlled DM documents.

      There are also further changes that could/should be made to the document, but this ticket is just about bringing old in-process work to a conclusion.

        Attachments

          Issue Links

            Activity

            Hide
            tjenness Tim Jenness added a comment -

            Most of the work done on this ticket was by Wil O'Mullane, with help from Jonathan Sick via DM-13140, so Architecture is probably not the right team. I've just done a final 15 minute tweak to the build system right at the end so I shouldn't really be the assignee. I can confirm that travis builds the document fine on my branch.

            Show
            tjenness Tim Jenness added a comment - Most of the work done on this ticket was by Wil O'Mullane , with help from Jonathan Sick via DM-13140 , so Architecture is probably not the right team. I've just done a final 15 minute tweak to the build system right at the end so I shouldn't really be the assignee. I can confirm that travis builds the document fine on my branch.
            Hide
            gpdf Gregory Dubois-Felsmann added a comment -

            Happy to review this when Tim Jenness is done.

            Show
            gpdf Gregory Dubois-Felsmann added a comment - Happy to review this when Tim Jenness  is done.
            Hide
            tjenness Tim Jenness added a comment -

            I'm done. The PR is at https://github.com/lsst/LDM-294/pull/54 on a user branch rather than a ticket branch because I wasn't sure at the time whether the broken-ness was meant to be there or not given that DM-13140 was completed and that was fixing the build (failures only occurred half the time).

            Show
            tjenness Tim Jenness added a comment - I'm done. The PR is at https://github.com/lsst/LDM-294/pull/54 on a user branch rather than a ticket branch because I wasn't sure at the time whether the broken-ness was meant to be there or not given that DM-13140 was completed and that was fixing the build (failures only occurred half the time).
            Hide
            gpdf Gregory Dubois-Felsmann added a comment -

            It looks like things are generally much better.  I think productlist.tex is still an example of an intermediate that is being kept in the repo and could be suppressed.  On the other hand, I am wondering about ProductTree.pdf.  I think there may have been an intent that it, or the landscape version of it, would be kept around after autogeneration so that it could be used on its own, not just embedded in LDM-294.  If that's true, is there somewhere else it could be stashed, e.g., by LTD?

            Show
            gpdf Gregory Dubois-Felsmann added a comment - It looks like things are generally much better.  I think productlist.tex is still an example of an intermediate that is being kept in the repo and could be suppressed.  On the other hand, I am wondering about ProductTree.pdf .  I think there may have been an intent that it, or the landscape version of it, would be kept around after autogeneration so that it could be used on its own, not just embedded in LDM-294.  If that's true, is there somewhere else it could be stashed, e.g., by LTD?
            Hide
            tjenness Tim Jenness added a comment -

            Merged and now it seems to build okay and has been updated on lsst.io.

            Show
            tjenness Tim Jenness added a comment - Merged and now it seems to build okay and has been updated on lsst.io.

              People

              • Assignee:
                tjenness Tim Jenness
                Reporter:
                gpdf Gregory Dubois-Felsmann
                Reviewers:
                Gregory Dubois-Felsmann
                Watchers:
                Gregory Dubois-Felsmann, John Swinbank, Jonathan Sick, Kian-Tat Lim, Tim Jenness, Wil O'Mullane
              • Votes:
                0 Vote for this issue
                Watchers:
                6 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:

                  Summary Panel