[osis-core] User manual bug list - 56 Sample document not valid

[Todd Tillinghast]

>56. Sample document is not valid. 
>Section 17.1.1: Based on the requirements in this section, the sample
>document in section 4 is not a valid OSIS document. [Missing creator,
date >in word. Missing revision element. Submitted by: Jim Schaad,
>jimsch@nwlink.com 

Resolution: 
I disagree with the requirements that a <work> element be required to
have any specific elements.  It should have at least one element.

CASE 1:
It is perfectly valid to have a <work> element with ONLY a <refSystem>
element.  This should be a very common case for use with "generic"
references to a scripture reference.
<work osisWork="bible">
   <refSystem>RefSystem.xxx</refSystem> <!-- replace xxx with the newly
enumerated reference system names -->
</work>

...
     <reference osisRef="bible:Gen.1.1"/>
...

This is a generic to reference to ANY work that supports the specified
reference system or that a mapping to a specified reference system is
available.

CASE 2:
In my view it is preferred to ONLY specify <identifier type="OSIS"> and
<refSystem> when declaring a <work> element to be used for making
references (not the first <work> element identifying "this" work
element).  By specifying other values the opportunity for introducing
error increases and does not increase the accuracy of a "match".

Todd