1 / 19

IHE ITI XDStar Volume 3, Section 4 Redocumentation Debrief

IHE ITI XDStar Volume 3, Section 4 Redocumentation Debrief. Gila Pyke Lead Facilitator/Cognaissance. Agenda. Review focus group feedback Gather additional feedback to Volume 3, Section 4 Present redocumentation progress so far and how it addresses focus group learnings

tyson
Download Presentation

IHE ITI XDStar Volume 3, Section 4 Redocumentation Debrief

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. IHE ITI XDStar Volume 3, Section 4 Redocumentation Debrief Gila Pyke Lead Facilitator/Cognaissance

  2. Agenda • Review focus group feedback • Gather additional feedback to Volume 3, Section 4 • Present redocumentation progress so far and how it addresses focus group learnings • Obtain additional direction • Next steps

  3. Focus Group Feedback

  4. Focus Group Feedback F1 - In most cases, expanding the number of examples and detailed definitions would assist those working with the documentation understand some of the nuances. For example, for queries on metadata, specify for each metadata field details about the process and results for responding to that query. F2 - There needs to b a detailed definition for all metadata fields that includes what they can/may contain (with examples). F3 - In all cases, it is important to ensure that example data in metadata fields is clearly marked as an example (e.g., “exampleCode”) so that it can be easily differentiated from required field contents or potentially say “in this example replace 'theDocument' with the actual document details”.

  5. Focus Group Feedback F4 - Definitions of Document, Document Entry, Submission Set and Folder needs to be earlier in the document. For clarity, knowing what something is before being told how it is used/requested, etc. is helpful. F5 - Business context for when or how something is used (this X would be used when you re doing Y) are needed for sections where it isn't obvious. F6 - For metadata concepts like displayName that are common to all metadata attributes, just skip the definition and make a statement that “all codes are mandated to have display names”

  6. Focus Group Feedback F7 - Summaries of what is in referenced documents/other volumes as well as link information are needed to ensure ease of use. Section specific feedback was also provided, please see slide ## for details

  7. Responses and Resolutions

  8. Focus Group Feedback and Responses F1 - In most cases, expanding the number of examples and detailed definitions would assist those working with the documentation understand some of the nuances. For example, for queries on metadata, specify for each metadata field details about the process and results for responding to that query. • The sections for DocumentEntry, Submission Set and Folder metadata have been completely restructured and expanded to give more detailed definitions and examples. • This expanded format also provides detail as to how the information is to be structured. However, query matching rules are part of Volume 2 and outside the scope of Volume 3, Section 4

  9. Volume 3, Section 4 Reorganization Additional high level explanations All original content from volume 3, Section 4 has been maintained. Content as been re-ordered, additional explanatory text and examples provided (~35 pages so far) Additional details and examples for each metadata attribute

  10. Focus Group Feedback and Response F2 - There needs to be a detailed definition for all metadata fields that includes what they can/may contain (with examples). • Detailed definitions for metadata fields, what they may contain as well as examples have been added to the new section 4.2.3 • New format provides old “summary tables” as well as examples and details for each metadata attribute for those who need them.

  11. Focus Group Feedback and Response F3 - In all cases, it is important to ensure that example data in metadata fields is clearly marked as an example (e.g., “exampleCode”) so that it can be easily differentiated from required field contents or potentially say “in this example replace 'theDocument' with the actual document details”. • Done. A complete edit of all examples was executed and metadata that was replaceable were marked as examples (e.g., “IDExample_54” or "ExamplepracticeSettingCode")

  12. Focus Group Feedback and Response F4 - Definitions of Document, Document Entry, Submission Set and Folder needs to be earlier in the document. For clarity, knowing what something is before being told how it is used/requested, etc. is helpful. • Done. • Abstract metadata model section added to the beginning provides definitions and descriptions of these object types and their characteristics.

  13. Focus Group Feedback and Response F5 - Business context for when or how something is used (this X would be used when you are doing Y) are needed for sections where it isn't obvious. • TBD – need help determining what types of examples could help resolve this

  14. Focus Group Feedback and Response F6 - For metadata concepts like displayName that are common to all metadata attributes, just skip the definition and make a statement that “all codes are mandated to have display names” • Done, automatic metadata like “displayName” are no longer defined in each instance.

  15. Focus Group Feedback and Response F7 - Summaries of what is in referenced documents/other volumes as well as link information are needed to ensure ease of use. • In progress. Where possible, codes are linked to specific section numbers (e.g., HL7 V2 Chapter 2a Section 89)

  16. Focus Group Feedback and ResponseSection Specific Feedback • Table 4.1-4 has a confusing title. • Table 4.1-3 should be moved after tables 4.1-5 to 4.1-7 • Table 4.1-5 simplify definitions in the table, do more of leaving details about attributes to separate section. • Section 4.1.8 improve the definition of contentTypeCode, including real world examples. Also improve format code • Section 4.1.8.1 was suggested to be elevated to it's own section. • The location of how to convey the order of the submission set was not easily located • The first sentence of 4.1.10 was seen as a note and should be moved down within the section • The tables in 4.1.10 are sometimes not clear enough. For example, it says “Issuing Authority” .. two words are insufficient • Section 4.1.11 needs to be more specific on how enforcement is affected and what the enforcement is based on (e.g., ebXML Section X) • Needs to be clear wither any part of this section applies to an actor in other profiles, like XCA, XDR, etc. • Section 4.1.13 is good about defining the data for an error but not about what produces an error • To be changed to something more pithy • In Progress. The restructuring is complex and new locations are being determined • Done • Done, each attribute has it's own subsection • Done • Done • TBD • Done • TBD • TBD • TBD

  17. Next Steps • Remaining working group teleconferences on Feb 21, March 7, possibly March 21 • Publish for “pre-public comment” to determine if redoc introduces enough value to publish for public comment If you are interested in participating in either of the above, please email gila@cogna.ca

  18. Where to find current materials All current documentation is on the IHE FTP at: ftp://ftp.ihe.net/IT_Infrastructure/iheitiyr11-2013-2014/Technical_Cmte/WorkItems/XDStarRedocumentationSupplement

More Related