V3 Publishing Committee Meeting Minutes, Q1, Wednesday, January 16, 2008, San Antonio, TX
Agenda:
- Agenda Confirmation
- Selection of two new V3 Publishing Co-Chairs
- Scheduling of Publishing for May 2008 WGM
- Overview of the HDF Presentation in V3 Ballot by Ioana Singuearu
- Next Steps
1. Agenda reviewed and approved.
2. Selection of New V3 Committee Co-Chairs – Traditionally, Publishing has had three co-chairs, two for V2 and one for V3. With Helen stepping down, we will be one co-chair short, but Helen highlighted an issue with current election procedure, i.e.-that the people most affected by co-chair elections are not able to take part in the election process because it takes place at the WGM. Helen proposes that the committee come up with nominees on the conference call (pre-announced) to select two nominees whose names will be taken forward to the Steering Division and then later confirmed by the TSC. The names put forward are Woody Beelers, Dick Harding, and Bob Hallowell.
Helen quickly reviewed some of the duties of the V3 Publishing Co-Chair and the time requirements.
Helen proposed that the announced call be Wednesday, January 23. Action: Helen to send an email to the publishing and co-chairs lists to announce this selection meeting.
3. Action: Helen to schedule Wednesday, Q1 and Q2 for V3 Publishing for the Phoenix (May 2008) WGM.
4. Ioana gave a quick overview of the HDF and its different forms of presentation, document, web and UML Enterprise Architect version. There followed a discussion of how documents, especially Word and PDF are presented with a historical preference for PDFs, because they can’t be edited, although this rationale is being questioned. The issue of the conversion of Word documents into XML was also raised. The discussion then broadened to include how all of the V3 ballot is put together and various issues arising from the hybrid approach it uses and then on to QA reviews of the ballot content.
The question was raised as to whether a tool like the UML modeler from Enterprise Architect could be used to construct the V3 Ballot, allowing committees to manage their current domains and models as well as bring in other document types such as Implementation Guides. Ioana demoed Rational Software Modeler 7.5, which is an Eclipse-based extensible tool that already has HL7 plug-ins developed for it.
5. Next steps:
Proposed Task – Identify candidate documents that could take advantage of UML-publishing method and then approaching the committees to see if they are interested in using this method.
Approach Tooling to see whether we can obtain licenses for Rational Software Modeler 7.5 for use in editing some of the V3 documents.
V3 Publishing Committee Meeting Minutes, Q2, Wednesday, January 16, 2008, San Antonio, TX
Agenda:
- Agenda Confirmation
- Task List Review
- PubDB Updates
- HTML/Presentation Updates
1. Agenda approved as stands.
2. Task List Review – Please refer to the updated V3 Publishing Task list for a complete listing of open and closed items; highlights follow.
Pub DB Updates. Woody reported that it is important to be able to do more than just desktop publishing out of the pub db and he will try to roll out improvements to allow committees to use the SVN repository to manage their files.
Action: Don to update V3 frameset to open directly to section 2 of the Notes to Readers.
Action: Don to explore whether it is technically possible to link to Topics in domains rather than just domains.
A new release of the generator is coming out of Canada that will generate MIF 2 as well as MIF 1 files. Woody to review and when it is out of testing it will be released.
ICTC (Sarah Ryan) is looking to create a guideline/template for HL7 working groups to use when created IGs for ballot. Dick to serve as liaison to establish some understanding, such as how this will be published, how it will be formatted, etc.
Need review of language for dispositions in the ballot comments spreadsheets. Action: Don to review where and when comment spreadsheet templates are posted for co-chairs to edit and return for use with their ballots.
Need new rendering of the Vocabulary content. This will be done out of the NLM project (by Woody and Ted Klein).
Action: Don to rename V3 Guide as V3 Guide for Voters.
Action: Don to check ballot icon status usage for non-UV content.
Action: Don to check with GB to determine status of GB realm-specific content in ballot and whether it can be removed.
Keith Boone (ARB) wants to create a publishing checklist for publishing facilitators to help them QA their domain ballot content.
Action: Woody and Don to add an ‘overarching changes’ section to the Ballot Notes to Readers.
Norman Daoust came in with questions and Helen gave him work. He expressed that there is a need to identity where in the Domains new requirements from the HDF will be published, i.e., use cases. We need a way to trace from requirements to the specifications as identified in HDF. Subsequently need to update tools (e.g., PubsDB) to support additional requirements/recommendations.
Meeting Adjourned for lunch at 12:33 PM. And there was great rejoicing!!!
Thursday Q3 – Joint with M&M
- Meeting Cancelled
V3 Publishing Task List
ID / Task / Resp. / Target Cycle / Notes / StatusQA Updates / Woody / 2008JanWGM
Need improvements to desktop publishing to support additional QA efforts. Tooling discussing eg: creating tooling repository in SVN to give committees directory structure to put files for publishing and for managing their own files. / New
1 / PubDb Updates / Woody / 2007Sep / 2007MayWGM
- Add fields to track CMETs to manage Status and Domain Assignment.
- Other updates needed - withdrawn for lack of support
- Desktop publishing update to update to current publishing transforms.
- Desktop publishing update to update to current publishing transforms.
- Could use a tooling volunteer to help do this who knows batch files and transforms.
- Add fields to track CMETs to manage Status and Domain Assignment.
- No new specifics. Still outstanding above requirements.
2 / HTML Updates / Don / 2007Sep / 2007JanWGM
- Lack of headers due to no section content. done
- Reorganize the Domains into UV and Realm specific. done
- Display the Domain and Topic formal ANSI names from a reference file. done
2007MayWGM
- Fix CMET clamshells to remove extra characters DONE
- Fix ANSI names to refine and review content and to automate DONE
- JanWGM DONE
- Need to retest clamshells problem. DONE
- ANSI Names are hand coded – needs to be automated. DONE
- Open ballot with Package Note to Readers section 2 Welcome. OPEN
- Request to link directly to topics from Section 4 – V3 Packages. Agree in principle; but need to check if technically possible.
- New rendering of Vocabulary content (support from NLM Project)
- Check ballot status icon usage for non UV content.
Non-UV Realm Content / Don / 2008JanWGM
- Determine status of non-UV content. Select (drop, refresh or republish existing). Default is to drop.
3 / Generator & Schema Generator Updates / Lloyd / 2007Sep / 2007JanWGM
- Produce table and excel views from New RMIM Designer XML to MIF files. DONE
- 2007/02/07: Woody to check and report. DONE
- 2007/02/14: Some progress – ETA new generator dependent on complexity and Woody’s availability. DONE
- Need to make path to view table views easier for PubFacilitators OPEN
- Assert Allowed Update Mode needs to be fixed (Gregg reported) DONE
- Fix issues found by Patrick Loyd (already on GForge) DONE
- Null flavour attribute is asserted twice in schemas for complex classes/associations. DONE
- Entry into choice box only picks up one node. Seen in ‘visio-direct’ method. DONE
- Issues still outstanding and entered into GForge. DONE
- New release in pre-release testing to include Canadian extensions to generate MIF2 in addition to MIF1 (plus some other Canada specific stuff).
4 / RMIM Designer / N/A / 2007Sep / 2008JanWGM
- Enable users to auto-generate clickable graphics without going into VISIO.
- UK CfH about to issue RFP for new tool
5 / V3 Guide for Implementers / Dick / 2008May Update / 2006MayWGM:
- Helen/Don/Andrew to work with Implementation committee to create a V3 Guide for Implementers.
2007MayWGM:
- The IC TC has agreed to a work item to start creating an Implementation Guide for implementers. Helen will continue to track this work.
2007/09/12
- Patrick attended call and there was discussion about structured documents; but no conclusions.
- ICTC (Sarah Ryan) looking to create a guideline/template for HL7 working groups to use to create implementation guides that might be balloted.
- Decision that developing the IG Template is ICTC role; however, need liaison to determine how template will be published and how IG’s created using the template will be published. Also, how does this affect/use the UML based authoring support (e.g. HDF)?
6 / Ballot reconciliation form / Don/Wendy / 2008Jan / 2006JanWGM:
- Disposition does not match text descriptions. DONE
- Is this Publishing’s responsibility? Need to reform a taskforce and get some resources to drive this. Problem with not being able to make dispositions because not in drop-down list.
- 2007/01/31: Wendy to work with Don to do QA & update worksheet. Problems identified include:
- Lab and Specimen domain are missing Need to add SIGs . DONE
- A-Q not included in instructions. DONE
- A-C not in selection. DONE
2007MayWGM:
- Form was updated in last cycle.
- Email from Virginia
- Issue: Section list did not include all the sections in the ballot and was restricted to not allow other. Will remove restriction from the field. DONE
- Issue: Still missing some disposition codes. “Question Answered” missing. DONE
- Form was enhanced as above, but Wendy identified some link problems. Need activity to review. OPEN
- Can we post the template on the publishing ballot page so it is available for TSC members to customize for their ballot and submit to Don? DONE (but sent to list)
- Need review of descriptions for dispositions – especially “Non-Persuasive with Mod”
7 / Ballot levels and document types / Freida / 2006Sep / 2005MayWGM:
- Research, document and obtain consensus on the types of documents (informative/normative/reference etc) and the ballot levels (informative, DSTU, committee, etc…).
- May be resolved in P&P.
- Need proper definitions that can be published – check HDF section 5.1. Don to review processes when ballot requests are submitted to ensure definitions on form match our definitions.
- No specific actions yet – Board/PIC/ORC working on new balloting definitions.
2007SepWGM:
- Project Lifecycle committee has defined I and N ballot types + DSTU as a trial implementation before N ballot submission. See attached document for strategic level discussion. HDF is defining tactical requirements – to be balloted in 2008Jan cycle.
- Freida new chair of Project Services. Closed task and refer to Project Services.
8 / Publishing extracted parts of standard / Woody / NE2008 / 2005/10/24:
- Publishing Extracts - We NEED a "widget" that can extract a single domain andthe things it is dependent upon from the collection of files that constitute an "Edition." With that in hand, then I would providea way for someone to create and 'publish' the extract.
2007/01/31: This is a tooling issue – Woody to get status/plan from tooling.
2007/02/07: Woody to add to tooling list.
2007/02/14: Tooling agreed to add as new task under gForge. Woody to create tracker on GForge.
2007/09/12
- No progress – but needs to stay on the task list.
- Confirm needs to stay on the task list.
9 / Online Ballot Index / TBD / 2008Jan / 2007MayWGM: HL7 UK Realm Publishing Requests:
End user requirements for a v.3 online ballot index
- Should appear at the end of the content tree on the first level (i.e., not hidden within another folder) where one would expect to find an index in the hardcopy world.
- Should be in alpha order
- Should drill down to at least to the Topic Level – possibly to the RMIM level
- Should be hyperlinked to ballot location
- Should not have a black background like the CMET navigation – rather, look like the vocabulary navigation
- Add to 2007SepWGM discussion to determine what approach we want and how to implement.
- Closed – no outstanding issues have been brought forward.
10 / V3 Guide for Voters Updates / Wendy Andrew / 2007May / 2006MayWGM:
- Focus should be “V3 Guide for Voters”; V3 Guide for Implementers will be developed separately.
- Change name to “V3 Guide for Voters” or similar to distinguish from Implementers.
- Take in the Methodology content that is not appropriate for the Package note to Readers
- Need to Understand What is in the Ballot
- Supporting Ballot specifically
- Andrew provided update that he is doing major revision and will work with Kate to harmonize content with PubFacGuide.
2007MayWGM:
- Updates were published, may not have included all requested changes. Wendy to check updates against task list.
- 2007May ballot contained updated version. Wendy to check if further updates are needed.
- Restructuring has been completed and Don to re-render.
- Examples still outstanding – Wendy to work with Andrew
- Change name to “V3 Guide for Voters” or similar to distinguish from Implementers. (Don)
- Take in the Methodology content that is not appropriate for the Package note to Readers
- Wendy gave Andrew example - will follow-up on getting it changed.
Package Note to Readers / Wendy / 2008Jan / 2007SepWGM:
- Take out the Methodology content that is not appropriate for the Package note to Readers DONE
- Add reference to UV and Realm to the Introduction and the diagram that shows the sections of the ballot.
- Section 2 is WRONG – needs to be corrected.
- Break into sections that are more readable.
- Highlight the content of section 4.1 – maybe move to LHMenu
- Section 3.3 graphics need to be checked against Project Services
Pub Facilitator Guide / Dick / 2008Jan / 2007SepWGM
- Add to Guide:
- Walkthroughs & descriptions SHOULD NEVER have ballot status or ballot sensitive information.
- Attribute level documentation should be shows as required.
- Reconfirm the Project Process documentation is aligned with new processes.
- ARB (Keith Boone) wants to create QA checklist for PubFacilitators. Dick is acting as liaison with ARB work and will look for any improvements to the PFGuide as part of this.
- Look for good examples of narrative diagrams for best practices under introductions/descriptions.
11 / Descriptive Diagrams / 2005SepWGM:
- Create template in VISIO for diagrams to support descriptive content. E.g. in FICR overview.
2007/02/07: Wendy takes ownership.
2007MayWGM:
- Wendy to work on for next cycle – no progress.
- Woody: we need to review this approach as we may move away from VISIO and will impact long-term support. On hold until verified if it is still required. Add to 2007SepWGM.
2008JanWGM:
- Close – not a priority at this time. Will look for some best-practices examples in PFGUide.
12 / Ballot Introduction
/ Publishing / 2007Sep / 2007MayWGM
2007/09/12
- Not done this cycle.
- Add ‘overarching changes in this cycle’ to Pkg Note to Readers introduction. Remove from Introduction.
- Update Introduction. (Project Services to support)
Update Domains to align w new HDF / Norman / 2008May / 2008JanWGM:
- Need to identify where in Domains new requirements from HDF will be published (e.g. Use Cases)
- Need to have a way to trace from Requirements to the specifications as identified in HDF.
- Initially identify the requirements and recommendations of how they are added to the published domains.
- Subsequently need to update tools (e.g. PubDb) to support additional requirements/recommendations.
- Concern to be addressed: some of the new artifacts do not have artifact identifiers so linking to/from will be an issue. Currently can be done with domain provided hyperlinks.