What format should be used to describe the competencies?

[openscript]

Each competency will be described with different sections of texts and some attributes like dependencies on other competencies. So what are the requirements to the format which will be used to describe the competencies? Here my suggestions:

• Readable for humans
• Interpret- and processable for machines
• Commonly known

[openscript]

How about XML?

[diegosteiner]

I agree with these requirements with the following order:

1. Interpret- and processable for machines (from which it can be converted into a more readable format for humans)
2. Commonly known (so it can be used by as many stakeholders as possible)
3. (somewhat) readable for humans

Most commonly known formats (to me) would include Markdown, XML, JSON, YAML

• Markdown: Although it would be very readable by humans, it is hard to add metadata that can be processed easily.
• XML: Not as readable as markdown, but very flexible and widely known
• JSON and YAML: Probably even harder to read as XML

I'd also go with XML or XML with embedded Markdown for text passages.

[diegosteiner]

Something among the likes of:

<?xml version="1.0"?>
<module nr="101" lang="de" field="Web Engineering" level="1" >
    <title>Webauftritt erstellen und veröffentlichen</title>
    <competence>
        Webauftritt erstellen und veröffentlichen
    </competence>
    <goal nr="1">
        <title>Vorgegebene Aufgabenstellung (Zielsetzung, Inhalte, Funktionalitäten) analysieren und Text- bzw. Grafikelemente für den Webauftritt auswählen.</title>
        <requiredknowledge nr="1">
            Kennt das Vorgehen bei der Situationsanalyse und weiss, welchen Beitrag dieses zur Definition eines klaren Auftrags liefert.
        </requiredknowledge>
    </goal>
    <goal nr="2">
        <title>Lösungsvorschlag für den Webauftritt (Site-Struktur, Navigation, Präsentation, usw.) ausarbeiten.</title>
        <requiredknowledge nr="1">
            Kennt die grundlegenden Unterschiede der verschiedenen Endgeräte hinsichtlich Funktionalität, Darstellung und Auflösung und Bandbreite der Netzwerkanbindung.
        </requiredknowledge>
        <requiredknowledge nr="2">
            Kennt Kriterien die bei der Strukturierung von Informationen auf Websites verwendet werden.
        </requiredknowledge>
        <requiredknowledge nr="3">
            Kennt die wichtigsten rechtlichen Rahmenbedingungen (Copyrights, illegale Downloads, Lizenzierungsbedingungen) bei der Verwendung fremder Inhalte.
        </requiredknowledge>
        <requiredknowledge nr="4">
            Kennt die gängigsten Medienformate für das Web und deren Einbindung in einer Webseite.
        </requiredknowledge>
        <requiredknowledge nr="4">
            Kennt die wesentlichen Gestaltungsregeln, die beim Einsatz von Schriften, Farben und Grafiken auf einer Website zu berücksichtigen sind.
        </requiredknowledge>
    </goal>
    <goal nr="3">
        <title>	Lösungsvorschlag mit einer Seitenbeschreibungssprache in einen Webauftritt umsetzen.</title>
        <requiredknowledge nr="1">
           Kennt Grundelemente von HTML und Style Sheets (CSS) und kann diese für die Erstellung einer Website einsetzen.
        </requiredknowledge>
        <requiredknowledge nr="2">
            Kennt die wichtigsten Grundelemente (Schrift, Farbe, Bild), die bei der Gestaltung einer Website berücksichtigt werden müssen.
        </requiredknowledge>
        <requiredknowledge nr="3">
           Kennt die Einsatzmöglichkeiten von PDF und kann Dokumente webgerecht aufbereiten.
        </requiredknowledge>
    </goal>
    <goal nr="4">
        <title>Webauftritt auf Erfüllung der Vorgaben aus der Aufgabenstellung überprüfen.</title>
        <requiredknowledge nr="1">
           Kennt eine Methode (z.B. Testen, Validierung) für die Erfolgskontrolle und kann deren Einsatz für die Bestimmung der Zielerfüllung erläutern.
        </requiredknowledge>
        <requiredknowledge nr="2">
            Kennt Testkriterien um die korrekte Funktionsweise des Webauftritts auf unterschiedlichen Endgeräten und Browsern sicherzustellen.
        </requiredknowledge>
    </goal>
    <goal nr="5">
        <title>	Webauftritt auf einem Webserver veröffentlichen.</title>
        <requiredknowledge nr="1">
            Kennt was beachtet werden muss, wenn die Website-Präsentation von der lokalen Arbeitsumgebung auf einen Web-Server übertragen wird.
        </requiredknowledge>
        <requiredknowledge nr="1">
           Kennt Werkzeuge zur sicheren Übertragung einer Website von einer lokalen auf eine serverbasierte Umgebung.
        </requiredknowledge>
    </goal>
    <objective lang="md">
        Webauftritt mit **Text**, Grafik, Animation und Links über maximal 3 Hierarchiestufen (ohne Server-/Clientseitige Programmierung). Zum Beispiel: 
        
        - Webauftritt für einen kleinen Verein.
        - Variante 2
        - Variante 3
    </objective>    
</module>

[openscript]

Great! That's exactly what I had in mind!