Category:SAIF Artifact Definition

Purpose

This wiki page provides a means for formally defining all of the artifact types that will be developed, maintained and published by HL7 committees under the SAIF methodology. This content will form a significant portion of HL7's SAIF implementation guide.

The artifact definitions attempt to identify the purpose for a given artifact, the reasons for its existence as well as the various constraints on when and how it is used and the content it may contain.

Process

The content of these artifact definition documents is open for editing to all participants in HL7 international. However, MnM requests that several guidelines be followed:

1. Follow the format defined in the SAIF Artifact Definition Template to ensure consistency and that all necessary aspects of the artifact definition are captured
2. Don't delete elements from either the template or the artifact definitions (though you can add comments suggesting they be deleted). Decisions to remove content will be made on committee conference calls
3. Make use of the "discussion" tabs for debate about the pros and cons of different approaches. The content in the artifact definitions themselves should only include content that would be expected to be included in the final publication (so a couple of sentences of rationale is fine for the main document. A three paragraph diatribe on why a given approach is better would best be handled in discussion.

At the moment, all of these artifact definitions are in an extremely draft state and the set is incomplete. In fact, the list of artifacts themselves is extremely incomplete. The purpose of the wiki is to gather contributions from the many stakeholders that are interested in the selection of artifacts and the rules associated with them. After we have reached a reasonable degree of consensus within MnM, ArB and possibly other committees (TSC, Structured Documents, etc.), these artifact definitions will be gathered into a publishable form and subjected to formal ballot review by the membership.