Long question names from validated instruments

For a use case in Germany, we are currently modelling several validated instruments from the psych domain. The questions/statements asked to participants and used to record answers in these instruments can vary significantly in detail and length.

In some cases, such as the Value-Based Stigma Inventory (VASI) questionnaire, it works well to include the full question as the element name. A draft model can be found here: Archetype Designer .

However, in other cases, such as the Adverse Childhood Experiences (ACE) questionnaire, the questions are much longer and may consist of multiple sentences. In these situations, including the full question in the element name becomes impractical. A draft model where the questions are placed in the description and the element is named with a shortend abbrevation, can be found here: Archetype Designer .

Any advice or guidance on best practices for naming such elements would be much appreciated. Should we aim for shorter, generic names and rely on the description for the full question text, or is there a preferred convention in openEHR for handling long question-based elements, that could be multiple sentences long?

Addendum:

Reading the styleguids for PROM and Scores on Condluence, I am also not sure if there is a general agreement on the labels used for instrument elements. In the PROM styleguide there is a sentance about using a “short text representing the content of the question” and in the Score styleguide it says “elements should be named as the exact text of the question in the source material”. This confuses me more and some insights would be much appreciated.

Relevant topic:

@linforest Thank you for pointing this out! I replied in your referenced thread, as it feels that there was no consensus yet.