This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Publishing Package Artifact Definition

From HL7Wiki
Revision as of 15:59, 21 April 2011 by Gwbeeler (talk | contribs)
Jump to navigation Jump to search

Return to Artifact List

Publishing Package - initial layout only

Alternate considerations:

  • Publication Package
  • Publishing Grouper
  • Publication Grouper

Definition and Purpose

A mechanism by which to define a package that organizes and documents a set of SAIF artifacts for publication. Its purpose is to support balloting and distribution of specifications using SAIF artifacts, and includes a means of documenting the package itself, over and above the documentation inherent in each of the artifacts that it is packaging. The packaging occurs by reference to SAIF artifacts that are stored elsewhere. The package is not a "container."

SAIF Matrix Location

This artifact is "Level-independent" because it is may be used to package artifacts at any level. Row(s)

  • Conceptual (CIM)
  • Logical (PIM)
  • Implementable (PSM)

Column(s)

  • Enterprise/Business
  • Information
  • Computational
  • Engineering
  • Technical

Audience

Briefly, publication packages may be assembled for any target audience.

Health Care Community Audiences:

  • General public
  • Health care practitioners
  • Health system administrators
  • Health care policy makers

Health Care Information Technology (IT) Audiences:

  • System designers and architects
  • System purchasers
  • Programmers/implementers
  • System vendor management

Applicability

This artifact provides a convenient way to assemble and document artifacts for publication. Therefore it will be created wherever and whenever a Work Group, project team, or HL7 publishers wish to publish SAIF artifacts for whatever purpose.

Rationale: Is designed as an aid for publication and will be core vehicle for the HL7 publishing software.

Requirements, Relationships and Content

  1. Provide a means for uniquely identifying the package to be published.
    1. Rationale Seems obvious.
  2. Provide a means to "include", by reference, a specific SAIF artifact, or an identifiable sub-component of that artifact for publication.
    1. Rationale The purpose is to publish SAIF artifacts and doing it by reference allows multiple such packages to include a given artifact without having to alter the content of the artifact itself. In some cases, it may be useful to, for example, include a single identified "class" from an information model.
  3. Provide a means for grouping (a sub-package, if you will) artifact references or other groups within the package.
    1. Rationale Such grouping allows the package to have a hierarchical structure (chapters, sections, etc. in order to facilitate understanding of the content.
  4. Provide ability to add documentation (with mark-up) that precedes and follows each group and reference in the package, including the package itself.
    1. Rationale Anticipate the need for "preceding" and "following" text that supplements the information in the components themselves.
  5. Include contextual data such as copyrights, authorship, responsibility, etc. to support publication.
    1. Rationale Handle the meta-data for the publication itself.

Relationships and traceability

  • Some relationship
    • Rationale: Reason for relationship
  • Some other relationship
    • Rationale: Reason for other relationship

Artifact types that may or must relate to this artifact types:

  • Many-related Artifact Type
  • Another Many-related Artifact Type

Content

  • Content element name - Brief Description
  • Another content element name - Brief Description
    • Sub-element name - Brief Description
  • Another content element name - Brief Description

Artifact Technology

Text here

Rationale

  • Some reason
  • Some other reason

Alternatives

Some technology

  • Some pro or con
  • Some other pro or con

Content Constraints

  1. Some rule
    1. Rationale: Some reason
  2. Some other rule
    1. Rationale: Some other reason

Content Guidelines

  1. Some rule
    1. Rationale: Some reason
  2. Some other rule
    1. Rationale: Some other reason

Publishing Representation(s)

  1. Some text
    1. Rationale: Some rationale
  2. Some other text
    1. Rationale: Some other rationale

Publishing Constraints

  1. Some rule
    1. Rationale: Some reason
  2. Some other rule
    1. Rationale: Some other reason

Tooling Considerations

  1. Nice-to-have|Required: Some feature
    1. Rationale: Some rationale
  2. Nice-to-have|Required: Some other feature
    1. Rationale: Some other rationale

Development Process Considerations

  1. Some text
    1. Rationale: Some rationale
  2. Some other text
    1. Rationale: Some other rationale

Governance Process Considerations

  1. Governance Process name - Some process description
    1. Rationale: Some rationale
  2. Another Governance Process name - Process description
    1. Rationale: Some other rationale

Issues

  • Some issue
  • Some other issue