...
Principle 1 must also be maintained at all times. CLOSER intends that the metadata documented is capable of being shared with other DDI compliant organisations, hence principle 1 ensures that CLOSER produces consistent and comparable metadata. The practice of keeping to principle 1 requires decisions to be made as to what questionnaire elements provide meaning. For example it was decided that bold font provided no semantic meaning and therefore CLOSER is not documenting the weight of the font. The order of multiple choice options was deemed relevant and therefore special care is taken to preserve the order within the documentation. The three following principles were conceived purposefully to give structure and guidance as to how the first principle should be followed at all times and in all situations. In example 2 below we can see that “Does the mother care for children at home ... ?” is in bold. We do not document this, however we do document that the order of the code list is Yes, No, No known.
Example 2 Birth Questionniare Questionnaire (BCS)
2. Do not correct the questionnaire
...
There are rare situations where principle 2 must be violated in order to follow principle 1 and principle 0. An example of this is can be seen in Example 3, when a code value is accidently printed with the wrong value. There is no easy way to alias code values and CLOSER's documentation would suggest that there are two distinctly different codes, while the dataset would only refer to one of the codes. In this case, documenting the mistake would mislead the user and violate Principle 1 and 0. As can be seen in Figure 4 the code values change partway down the right hand column. This causes an issue while documenting as it is not possible to change a Code Answer part way down a Question Grid, therefore the question can no longer be documented as a single Question Grid. In addition to this, it is highly unlikely that the change of code value was intentional; so it is also highly unlikely that the dataset would reflect the mistake. In this situation it is deemed appropriate to violate principle 4 and check if the dataset contains any values of 3, or were they all recorded as 1. If it is confirmed that the code values of 3 are a mistake then correcting the code values provides a more accurate documentation of the structure of the question and how the question is mapped to the data collected.
Example 3 Questionniare Questionnaire My Little Boy/Girl (ALSPAC)
...
Example 4 provides an example of where the metadata must be added in order to maintain Principle 1 is when a questionnaire uses an arrow to denote a condition.It It is impossible to document an arrow literally and leaving it out of the documentation altogether changes the logical flow of the questionnaire and violates principle 0 of making sense. Therefore, text representing the arrow's meaning has to be added.
...