Where to put information about a version change of a code list?

["Wackerow, Joachim" <Joachim.Wackerow@gesis.org>]

Ken and others,

 

As you might know, the DDI Alliance is using Genericode for controlled vocabularies in the domain of statistical (meta-)data. See:

http://www.ddialliance.org/Specification/DDI-CV/

http://www.ddialliance.org/controlled-vocabularies.

 

We would like to publish now a new version of one of these code lists. The information on the changes in the new version should be included. I didn’t find a specific element for this purpose.

 

I see the possibility to invent a custom class in the annotation/description section for a specific Row or specific column Value. Like:

<SimpleCodeList>

   <Row>

     <Annotation>

       <Description>

         <h:div xml:lang="en-US" class="Change">

           <h:p>New entry.</h:p>

         </h:div>

       </Description>

     </Annotation>

     <Value ColumnRef="Code">

       <SimpleValue>Individual</SimpleValue>

     </Value>

     <Value ColumnRef="Term">

       <Annotation>

         <Description>

           <h:div xml:lang="en-US" class="Change">

             <h:p>wording change.</h:p>

           </h:div>

         </Description>

       </Annotation>

       <ComplexValue>

         <ddi-cv:Value xml:lang="en-US">Individual person</ddi-cv:Value>

       </ComplexValue>

     </Value>

 

Are there other common ways to express this?

Any advice is appreciated.

 

Cheers,

Achim