ddialliance / ddi-c_2

DDI Codebook schema 2.x
https://ddialliance.org/Specification/DDI-Codebook/
Other
1 stars 3 forks source link

catgryGrp attributes #21

Closed dusadrian closed 3 months ago

dusadrian commented 3 months ago

Two of this element's attributes, compl and excls are defined as xs:NMTOKEN, with only two values: true and false. Many other attributes are defined as xs:boolean, shouldn't these attributes be the same?

The attribute catgry is listed but no description of it can be found in the element's documentation, and there are no examples to at least infer its purpose.

wlthomas commented 3 months ago

These 2 attributes have existed in this format since the beginning. Retaining this limit disallows the use of 0 | 1. Maybe something for a future discussion of structural change to Codebook but not for 2.6

I'll add documentation on catgry attribute.

On Sat, Jul 20, 2024, 10:11 Adrian Dușa @.***> wrote:

Two of this element's attributes, compl and excls are defined as xs:NMTOKEN, with only two values: true and false. Many other attributes are defined as xs:boolean, shouldn't these attributes be the same?

The attribute catgry is listed but no description of it can be found in the element's documentation, and there are no examples to at least infer its purpose.

— Reply to this email directly, view it on GitHub https://github.com/ddialliance/ddi-c_2/issues/21, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAJT47KX3UNLHIAN5XQN2TTZNJ4ZVAVCNFSM6AAAAABLGAKL22VHI2DSMVQWIX3LMV43ASLTON2WKOZSGQZDAOJTHA3TQOA . You are receiving this because you are subscribed to this thread.Message ID: @.***>

wlthomas commented 3 months ago

Source verification: these attributes were added in the 2.0 version of the DTD and transformed into the schema using a restriction base of NMTOKEN for all internal enumerations. Later additions to the schema brought in the use of xs:boolean.

Added documentation on the use of the attributes "catgry" and "catGrp". Use the attribute "catgry" (IDREFS type) to provide a space delimited list of the ID of each category in the parent category group. The attribute "catGrp" (IDREFS type) is used to indicate all the subsidiary category groups which nest underneath the current category group. This allows for the encoding of a hierarchical structure of category groups. Do not list the categories contained in a listed "catGrp" within the attribute "catgry". These two IDREFS attributes should list ONLY the direct children of the parent category group.

THIS WILL BE IN NEXT PULL REQUEST FOR JULY 23