Uploaded image for project: 'Request For Comments'
  1. Request For Comments
  2. RFC-619

Accept new Software Release Management document (LDM-672)

    Details

    • Type: RFC
    • Status: Implemented
    • Resolution: Done
    • Component/s: DM
    • Labels:
      None

      Description

      This document provides release policies and high-level release management approach for software products releases.

       

      The document previs is available at:

      https://ldm-672.lsst.io/v/RFC-619/index.html

       

        Attachments

          Issue Links

            Activity

            Hide
            tjenness Tim Jenness added a comment -

            Looks okay in general. LDM-564 needs to be cited properly so it turns up in the references. We also mention LSP and define it in the glossary but don't cite the LSP design document. (maybe the glossary should include the relevant LDM with a citedsp? Should the RFC glossary entry include a URL to the RFC jira project?). I'm not sure why clearpage is being used after each section ends; that's not generally how we write LDMs. Finally, I would prefer we not use "SW" when we mean "software" – it's not really that much more to type.

            Show
            tjenness Tim Jenness added a comment - Looks okay in general. LDM-564 needs to be cited properly so it turns up in the references. We also mention LSP and define it in the glossary but don't cite the LSP design document. (maybe the glossary should include the relevant LDM with a citedsp? Should the RFC glossary entry include a URL to the RFC jira project?). I'm not sure why clearpage is being used after each section ends; that's not generally how we write LDMs. Finally, I would prefer we not use "SW" when we mean "software" – it's not really that much more to type.
            Hide
            gcomoretto Gabriele Comoretto added a comment -

            Thank you Tim for your comments.

            I have added the `\citeds` in LDM-564, added a reference to LSE-319 for the LSP and replaced the `SW` with `software` in the text, but not in the table.

            I think that the `\newpage` before each new section makes the document more readable. I can remove it if this is against the LSST documentation policy, otherwise, I prefer to keep it.

            Show
            gcomoretto Gabriele Comoretto added a comment - Thank you Tim for your comments. I have added the `\citeds` in LDM-564, added a reference to LSE-319 for the LSP and replaced the `SW` with `software` in the text, but not in the table. I think that the `\newpage` before each new section makes the document more readable. I can remove it if this is against the LSST documentation policy, otherwise, I prefer to keep it.
            Hide
            tjenness Tim Jenness added a comment -

            My comment regarding the newpage was mainly that no other formal LSST document does this. If no-one else is bothered I will let it drop.

            Show
            tjenness Tim Jenness added a comment - My comment regarding the newpage was mainly that no other formal LSST document does this. If no-one else is bothered I will let it drop.
            Hide
            swinbank John Swinbank added a comment - - edited

            My comment regarding the newpage was mainly that no other formal LSST document does this

            Being picky, I think the DMTRs do, although, curiously, not before every section.

            Personally, I'm not a big fan of this style, but it doesn't bother me enough to actually object.

            Show
            swinbank John Swinbank added a comment - - edited My comment regarding the newpage was mainly that no other formal LSST document does this Being picky, I think the DMTRs do , although, curiously, not before every section . Personally, I'm not a big fan of this style, but it doesn't bother me enough to actually object.
            Hide
            tjenness Tim Jenness added a comment -

            The DMTRs generated from Jira are presumably using a template created by Gabriele Comoretto

            Show
            tjenness Tim Jenness added a comment - The DMTRs generated from Jira are presumably using a template created by Gabriele Comoretto
            Hide
            gcomoretto Gabriele Comoretto added a comment -

            I will homogenize the DMTR template if there are no strong complaints about it.

            Show
            gcomoretto Gabriele Comoretto added a comment - I will homogenize the DMTR template if there are no strong complaints about it.

              People

              • Assignee:
                gcomoretto Gabriele Comoretto
                Reporter:
                gcomoretto Gabriele Comoretto
                Watchers:
                Colin Slater, Gabriele Comoretto, John Swinbank, Jonathan Sick, Kian-Tat Lim, Leanne Guy, Michelle Butler, Tim Jenness, Wil O'Mullane
              • Votes:
                0 Vote for this issue
                Watchers:
                9 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:
                  Planned End:

                  Summary Panel