Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Date of Preliminary Handover meeting: 

Date of Initial Handover meeting:   

Attendees

  • Maria Braithwaite (MBR)
  • Kai Kewley (KKE)
  • Peter Williams (PWI)
  • Monica Harry (MHA)

Date of Final Handover meeting:  

Attendees

  • Andrew Atkinson (AAT)
  • Maria Braithwaite (MBR)
  • Donna Morgan (DMO)
  • Kai Kewley (KKE)
  • Peter Williams (PWI)
  • Rory Davidson (RDA)
  • Monica Harry (MHA)

Apologies


Page properties


title

Handover Status

Status
colourGreen

FINAL




Agenda

 

Items to be discussed

Actions

1

Prerelease Content Management Activities:

  1. Verify that all namespace concepts (in the namespace registry) have been added
  2. Inactivate the root concept synonym referencing previous release, and add synonym to reference current release.
  3. Update copyright date on synonym (January releases only; N/A to July 2014)
  4. Send updated laterality indicator spreadsheet to technical team to support qualifier generation.
  5. Get SE and SP refset files from Yong



 

  1. MBR - confirmed with Yohani 5 Nov 2019

  2. MBR - done please see INFRA-3968

  3. MBR - update root concept and synonym please see INFRA-3968

  4. ACTION: Yongsheng Gao to deliver laterality indicator, as this now comes from the Refset tool ... AAT to receive from Yong  

    1. YONG confirmed he would complete the refset by cop on ............., so once Maria reviewed as well AAT should receive the completed version by ........... at the latest.

    2. YONG Delivered as requested on

     Yong on leave today, email sent to prepare files for 13 Nov 2019


  5. ACTION: Yongsheng Gao to deliver SE and SP files, AAT to receive from Yong  

    1. YONG confirmed he would complete the refset by cop on ............., so once Maria reviewed as well AAT should receive the completed version by ............. at the latest.

    2. YONG Delivered as requested on

    Yong on leave today, email sent to prepare files for 13 Nov 2019

2

Content Validation Activities:

  1. Concepts that have changed its high level hierarchy ancestor since last release
  2. Concepts with FSNs with changed semantic tags
  3. Active concepts with changed FSNs (check for shifts in meaning)
  4. Concepts *in*-activated since the last release
  5. Concepts *re*-activated since the last release
  6. Concepts that changed from fully defined to primitive
  7. Concepts that changed from primitive to fully defined
  8. New FSNs: Check for adherence to naming conventions, no acronyms, etc.
  9. Spell checking for new descriptions and/or manual inspection
  10. Review all new and changed text definitions
  11. Additions/removals of members of VMP refset (Inactive concepts still in the VMP refsets are removed during release extraction)
  12. Additions/removals of members of VTM refset (Inactive concepts still in the VTM refsets are removed during release extraction)
  13. Verify that there have been no changes to the Non-human refset in the Workbench.
  14. Additions/removals of members of ICD-O simple map refset (Inactive concept still in the ICDO map are removed during release extraction)
  15. Active concepts having active historical associations and reasons for inactivation

MBR has been analysing the Daily Build RVF results for the past few weeks, and working with Peter to clear down the failures. We just, therefore, need to confirm that the RVF report is now:

a) RVF report being checked on a daily basis with the intention of having it cleared down completely by the handover on 8 Nov 2019

b) To be clean by the Final Handover meeting (before we version the content) to confirm 18 Nov 2019

. Early Alpha run by AAT 1st Nov 2019:

assertionText" : "All language refset members inactivated in current snapshot must have been active in the previous release." - https://jira.ihtsdotools.org/browse/INFRA-4306 FIXED

assertionText" : "Preferred Term exists exactly once in each language refset for each concept." - https://jira.ihtsdotools.org/browse/INFRA-4313 FIXED

assertionText" : "Concept should not have any duplicated historical association indicators." - https://jira.ihtsdotools.org/browse/INFRA-4312 FIXED

assertionText" : "All OWL Expression inactivated in current release must have been active in the previous release." - https://jira.ihtsdotools.org/browse/INFRA-4308 FIXED

assertionText" : "There is a 1:1 relationship between the id and the key values in the ASSOCIATION REFSET snapshot file." - https://jira.ihtsdotools.org/browse/INFRA-4317 FIXED

assertionText" : "There is only one member id per description per dialect in the language refset snapshot file." - https://jira.ihtsdotools.org/browse/INFRA-4318 FIXED

assertionText" : "Relationship groups contain at least 2 relationships." - https://jira.ihtsdotools.org/browse/INFRA-4197 NOT AN ERROR NEEDS CHANGE TO RVF

assertionText" : "Active concepts must have at least one IS A relationship." – 138875005 ROOT CONCEPT NO CHANGES NEEDED https://jira.ihtsdotools.org/browse/INFRA-4197

assertionText" : "An FSN containing the word \"pre-filled\" must be changed to prefilled." – AWAITING CHANGE TO RVF REPORT TO REMOVE ASSERTION https://jira.ihtsdotools.org/browse/ISRS-574

assertionText" : "It is not allowed to add a subtype as a parent." – CHECKED WITH TMO, JCA, YGA NO CHANGES NEEDED.

Warnings relating to language ref set inconsistencies, special characters in FSN, case significance, capitalisation etc –a large number of issues  addressed during this release cycle, there should be a reduction in the overall number of issues relating to the language ref set since the July release through efforts to ‘fix’ content where needed and also changes to the language ref sets in the author platform. 

Ticket logged for changes to the RVF report to allow us to identify active versus inactive concepts to help us to prioritise areas of content that need review going forwards https://jira.ihtsdotools.org/browse/INFRA-4052

Ticket is logged to align case sensitivity rules in the RVF with the editorial guidance which should also see a reduction in warnings relating to case sensitivity - https://jira.ihtsdotools.org/browse/INFRA-4301

Will log a new ticket to ask for ability to whitelist in RVF report for correct content that is currently showing upfor various reasons.ACTION: Maria Braithwaite to share the Content report results with the content team - will confirm whether or not any fixes are required before the Alpha release

Maria confirms:

https://jira.ihtsdotools.org/browse/RP-127 - all issues resolved for Jan 2020 release, new report in RP confirms no new issues.

https://jira.ihtsdotools.org/browse/RP-165 - all issues resolved for Jan 2020 release, no new issues in RP report.

MBR will share content report with team when it is ready.


 

3

Content Team Support availability - Confirm which members of the content team will remain on stand-by until clean database milestone is achieved after release build file QA and post-release assertions are validated.

Maria , Donna and Yong will all be around to support wherever needed .Donna and Yong on leave at present (8 Nov 2019)

 

4

Early visibility of Release Notes

 

Andrew Atkinson has created the template to update on Confluence: SNOMED CT January 2020 International Edition - SNOMED International Release notes - content team to update with relevant figures for January 2020 content.....

ACTION: Maria Braithwaite and Donna Morgan will kindly aim to get them to Andrew Atkinson by 15 November 2019

ACTION: Monica Harry and Paul Amos to review and approve once complete

 

5

Discussion of existing Known Issues from the previous Release

 

  1. ISRS-365- Long term "part of" fixes - current status - May 2019 update has dependency on the implementation of DL enhancements. ACTION: Yong to close ticket....DONEISRS-366 - Long term case significance fixes - May 2019 review work completed, requires implementation into editing environment, meeting planned to discuss 8 May 2019. To be carried over to Jan 2020work has commenced for this, it will be ongoing over subsequent releases.
  2. ISRS-409- Specific case significance issue - I have asked JCA for an update, no immediate action, requires wider consultation. To be carried over to Jan 2020 
  3. ISRS-414- Non breaking spaces - fixed please see INFRA-3329 - ACTION: fixed, just need to validate in this release cycleISRS-459 - resolved by Maria in
    Jira
    showSummarytrue
    serverIHTSDO JIRA
    serverIdb202d822-d767-33be-b234-fec5accd5d8c
    keyINFRA-2984
    non breaking spaces fixed please see line above INFRA-3329ACTION: fixed, just need to validate in this release cycle
  4. ISRS-464 - Veterinary inactivation issues - not an error, a new concept was added for July 2019 but the original inactivation is correct. Feedback provided to UKTC via Freshdesk ticket. ACTION: fixed, just need to validate in this release cycle
  5. ISRS-487 - MRCM domain issues - ACTION: fixed, just need to validate in this release cycle
  6. ISRS-489- MRCM updates - part two of the changes we implemented in Jan 2019 - Maria completed the warning, ACTION: Linda to finalise....DONE - AAT provided LInda with UUID to standardise early so David could continue with HRCM prep...
  7. 575 - no action, being resolved over time with template based editing as part of QI project.
  8. ISRS-574 - requires change to RVF report to remove this assertion altogether.
  9. ISRS-582checked no author changes required.
  10. INFRA-4197 - 147,000+ issues, needs change to assertion to allow self grouping, no editing changes needed.
  11. ISRS-562 - Finding with explicit context| concepts using |Associated Procedure| attribute - editing issue resolved.
  12. ISRS-563 - 8 concepts using |Surgical approach| that are not subtypes of |surgical procedure| - editing issue resolvedISRS-491 - MRCM constraint issues - ACTION: fixed, just need to validate in this release cycle, fixed this duplicates number 7 above.
6Brief run through of the known issues already identified by the content team during the QA batch process, to ensure that technical team are aware of them, and can either resolve them in time for the release, or confirm as known issues.
  1. Jira
    serverIHTSDO JIRA
    serverIdb202d822-d767-33be-b234-fec5accd5d8c
    keyMAINT-722
    - these should be false positives, and RVF fix has been deployed so we just need to verify that this has cleared down the report... ACTION: fixed, just need to validate in this release cycle

Mapping: Clean after initial meeting - how are we looking for meeting the planned delivery timelines - DONNA confirmed all on track

Mapping: 8 Nov 2019 Donna is on leave today she sends this update:

Technical QA has started. SNOMED has been reloaded and 1 concept has been identified as needing a map in the ICD-10 project - Drip feed must not have picked it up. The concept  32941000119104 Ingestion of toxic substance (disorder) has been mapped and WCI can re commence the release work. GMDN and ICD-O have been completed and WCI notified. Both projects will need to pass technical QA but nothing to report so far.



7Versioning and Change Freeze

KAI TO RUN ONE FINAL MANUAL OWL DAILY BUILD BEFORE WE VERSION JUST TO DOUBLE CHECK NO UNEXPECTED CONTENT ISSUES.... HE WILL RUN EITHER THIS AFTERNOON OR TOMORROW MORNING (FRIDAY 10th) - COMPLETED with reasonably clean results.

AAT to then get a clean Alpha package built before we can sign off content for versioning...finally got a clean build on  

AAT to request Rory/Michael to action after all above confirmed.....Versioning and branching completed and authoring tool re-opened on  as planned.

Validation up and running immediately due to no more reliance on the AMI!! - Maria and team to let us know immediately if any issues found in the validation as might be a few initial niggles...

????????Versioning completed and initial successful builds run - will confirm properly once final validation run after mapping files delivered....has run some manual checks for missing descriptions - no issues found.

8Stats Report

MBR has now been using the Daily Build QA report (which will contain data from the next Release Cycle by the time this Release is published) - for stats and has the information needed for release notes, also given access to https://dailybuilddocs.ihtsdotools.org/qa/

ACTION: Maria Braithwaite will run the spell check and RVF one final time after the cut off is complete - completed 7 May 2019

MBR can also now use this for the stats in the Release Notes, as once content cut off is complete, this Daily Build report will show the static version for the July 2018 International Edition.

ACTION: Maria Braithwaite The only thing we need to be careful of here is large updates during Alpha/Beta release cycle - so MBR to run this again after Beta release is complete and update Release Notes if required - done??

google.com/spreadsheets/d/1hgDBPG5TjarvGpRJD6LBUN1sHLizhWWchzWDXXjpPRk/edit#gid=3 by Peter for further information that will be useful for release notes.


9Risks
  1. Kai - After versioning need to take care when rebasing some projects that still have content on them as never done before on this terminology server and may find strange behaviour - mitigation: Kai will do the rebasing after we have versioned. This will be done before editing reopens
9Risks
OWL Daily Build has not yet been automated and run, and so Maria has not had sight of the results of this before the handover.
ACTION: We therefore need to run some additional checks to ensure that there are no unexpected issues - KAI TO RUN ONE FINAL MANUAL OWL DAILY BUILD BEFORE WE VERSION JUST TO DOUBLE CHECK NO UNEXPECTED CONTENT ISSUES.... HE WILL RUN EITHER THIS AFTERNOON OR TOMORROW MORNING (FRIDAY 10th) - COMPLETED and the few minor issues found have now been fixed - in test now with aim to get them into Production before the Alpha release...

ACTION: PLUS Andrew to run the preliminary version of the OWL Delta that Kai has produced through the early validation builds and ensure no failures in the RVF or DROOLS... DONE

The next risk is that we don't have the full OWL functionality in place in the termServer as yet - this is coming soon, but not quite in time for the July 2019 release. This is resulting in us having to follow several workarounds for creating the OWL files as we promised for this release package. These workarounds are manageable, but quite manual, and so naturally introduce some additional inherent risks that wouldn't be there if we had the full end to end OWL solution in place already. We will mitigate this with as much validation as is possible in the time, but we should still acknowledge this as a potential risk to the quality of the end deliverables.
The other risk is that we still don't have a final decision as yet on the format of the OWL content in the RF2 files -
  • Snapshot file - Whether or not to use flat July 2019 effectiveTimes against every record in the OWLExpression files (except those already published in July 2018 + Jan 2019), or whether to try to align the effectiveTimes with the previous Snapshot state from each related Stated Relationship record.
    1. This would make sense, as there would be continuity from a Stated Relationship record that hasn't been updated since, say, 20100131 - as the OWL record replacing it would start from that last known update time and therefore have an effectiveTime of 20100131 instead of 20190731.
    2. However, it contravenes RF2 paradigm somewhat, as
      1. The fact that the OWL record didn't technically exist (or was published) prior to 20190731 means that having an effectiveTime years before this breaks the RF2 format by "inventing" history (something that the people who requested this Full OWL file in the MAG have previously vehemently opposed!).
      2. Technically it contradicts the statuses in the Full file of the Stated Relationships file, which will still be in the package, and will still state that the Stated Rel records were active until July 2019.
  • Full file - Some people would like the Full file to have a full history all the way back to 2002, showing the OWL statuses in line with each related Stated Rel change for the entire history of SNOMED CT.
    1. This however, will take a long time to validate, so at this stage given that no work has been done on this yet, would potentially be a risk to the delivery of the July 2019 Release.
  • Delta file - The Delta file has been requested to include ONLY those OWL records that have had changes made to them since the last Jan 2019 release.
    1. However, this again contravenes RF2 paradigm as:
      1. The Delta file must contain all NEW records as well as updated records, and as all of the OWL records in question are new (despite many of them not having had their related Stated Rel changed for years) this would result in an invalid Delta from the Jan 2019 release
      2. The Delta file should also be representative of the changes to the Snapshot, so technically if we're making the effectiveTimes artificially align with the previous states of the related Stated Rel records, the Delta should also contain multiple previous effectiveTimes. This is again in contravention with the RF2 format of including only the latest changes in the Delta files. So in this case only changes made in the July 2019 cycle should be in the Delta, which is technically the case here, but the older effectiveTimes may cause problems for some users' systems.
      3. If, on the other hand, we align the Snapshot effectiveTimes with the historical states, yet have the Delta containing all new July 2019 effectiveTimes, we will then have a misaligned Delta/Snapshot...
  • Really, we should either:
    1. Retain the Stated Relationship files (inactivated) and add in the OWL files with the July 2019 effectiveTimes, and full Delta files - as per the 2x Demonstration releases that we've published out and had signed off by the community, or
    2. REPLACE the Stated Relationship files completely (remove them from the Int Release package) and add in the OWL files with the artificially aligned effectiveTimes, in order to retain the full history.
  • ACTION: A decision must be taken quickly, that takes into account the needs of both the vocal people in the community, but also those Members and Affiliates who aren't present at conferences etc but who may have read all the plans/warnings about the upcoming OWL changes and have made system changes ready to consume them (possibly even via Delta's)
  • ACTION: WHATEVER IS DECIDED HERE MUST BE COMMUNICATED OUT TO THE COMMUNITY ASAP, TO GET AGREEMENT FROM EVERYONE BEFORE WE PROCEED WITH THE ALPHA RELEASE NEXT WEEK...
  • DECISION TAKEN: to continue with the blanket July 2019 effectiveTimes in all OWL files (as per the 2x Demonstration releases that we've published out and had signed off by the community), and to retain the Stated Relationship files (inactivated). Decision make in the meeting with Rory, Yong, Kai and Maria at 14:00 on 10/05/2019
  • Other than that, no known risks! Everyone comfortable so far...

    No new risks raised in the Final Handover meeting - everyone signed off ready to proceed as planned..
    1. .
    10