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

Difference between revisions of "Issues with SAIF Artifact Definition"

From HL7Wiki
Jump to navigation Jump to search
(Created page with "{{subst::Template:SAIF Artifact Definition}}")
 
Line 1: Line 1:
 
+
<!-- [[Category:SAIF Artifact Definition]] -->
[[Category:SAIF Artifact Definition]]
 
 
[[:Category:SAIF Artifact Definition|Return to Artifact List]]
 
[[:Category:SAIF Artifact Definition|Return to Artifact List]]
 
+
=By Section=
=Some Artifact Name=
+
No problem with:
 
+
*Some Artifact Name
<!-- Artifact names should be descriptive and short.  They may change as we further refine the methodology -->
+
*SAIF Matrix Location
 +
===NEW SECTION - '''specializes''' or '''restricts''' or '''includes''. another SAIF A D===
 +
We are going to end up with a '''MAINTENANCE NIGHTMARE''' if end up with individual SAIF Artifact Definitions for
  
 
== Definition and Purpose ==
 
== Definition and Purpose ==
 
+
Issue: Are not "content" and "relationship" assertions an integral part of some definitions?
<!-- At a high level, what is this artifact and why is it needed? Should ideally be only a few sentences -->
 
 
 
Put text here
 
 
 
== SAIF Matrix Location ==
 
 
 
<!-- Where does this artifact fit into the SAIF matrix?  Delete those rows and columns that do not apply and provide qualification if appropriate -->
 
'''Row(s)'''
 
* Conceptual (CIM)
 
* Logical (PIM)
 
* Implementable (PSM)
 
 
 
'''Column(s)'''
 
* Enterprise/Business
 
* Information
 
* Computational
 
* Engineering
 
 
 
 
== Audience ==
 
== Audience ==
 
+
Suggest we need a common classification for audience types by both "community" of interest and "role" in defining or using HL7 specifications
<!-- Who will be the consumers of this artifact type and what will they do with it? -->
 
Text
 
 
 
 
== Applicability ==
 
== Applicability ==
 
+
How much does this differ from "SAIF Matrix Location"?
<!-- Under what circumstances does this artifact type need to be created? Are there circumstances where this artifact should not exist?  Why? -->
 
Text
 
 
 
<i>Rationale</i>: More text
 
 
 
 
== Requirements ==
 
== Requirements ==
 
+
I fear we are have two issues here:
<!-- What are the needs that this particular artifact was created to satisfy and why are those needs important.  (Should not be more than 10-15.) -->
+
#'''Traceability''' - How do I reference my relationships and content constraints back to specific requirements
# Some requirement
+
#:
## <i>Rationale</i>Some reason
+
#'''Redundancy''' - It is very difficult to state a "requirement" without simultaneously defining either a relationship or a constraint, yet we do NOT want to define these in two places.
# Some other requirement
 
## <i>Rationale</i>Some other reason
 
 
 
 
== Relationships and traceability ==
 
== Relationships and traceability ==
  

Revision as of 14:47, 8 April 2011

Return to Artifact List

By Section

No problem with:

  • Some Artifact Name
  • SAIF Matrix Location

NEW SECTION - specializes' or restricts or includes. another SAIF A D

We are going to end up with a MAINTENANCE NIGHTMARE if end up with individual SAIF Artifact Definitions for

Definition and Purpose

Issue: Are not "content" and "relationship" assertions an integral part of some definitions?

Audience

Suggest we need a common classification for audience types by both "community" of interest and "role" in defining or using HL7 specifications

Applicability

How much does this differ from "SAIF Matrix Location"?

Requirements

I fear we are have two issues here:

  1. Traceability - How do I reference my relationships and content constraints back to specific requirements
  2. Redundancy - It is very difficult to state a "requirement" without simultaneously defining either a relationship or a constraint, yet we do NOT want to define these in two places.

Relationships and traceability

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

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


Issues

  • Some issue
  • Some other issue