# Accept new Software Release Management document (LDM-672)

XMLWordPrintable

## Details

• Type: RFC
• Status: Implemented
• Resolution: Done
• Component/s:
• 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

## Activity

Hide
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
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
Gabriele Comoretto added a comment -

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
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
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
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
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
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
Tim Jenness added a comment -

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

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

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

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

## People

• Assignee:
Gabriele Comoretto
Reporter:
Gabriele Comoretto
Watchers:
Colin Slater, Gabriele Comoretto, John Swinbank, Jonathan Sick, Kian-Tat Lim, Leanne Guy, Michelle Butler, Tim Jenness, Wil O'Mullane