Änderungen

Wechseln zu: Navigation, Suche

ART-DECOR Governance

1.336 Bytes entfernt, 14:23, 7. Nov. 2019
Struktur eines CDA-Implementierungsleitfadens
== Struktur eines CDA-Implementierungsleitfadens ==
Ein Implementierungsleitfaden muss folgende Abschnitte enthalten:* eine Folgende Angaben hinsichtlich des [[Hilfe:Leitfaden_erstellen#Infobox Aufbau_eines_Implementierungsleitfadens|Infobox ]Aufbaus einen Implementierungsleitfadens] (für den Leser nicht sichtbar)* die Hinweis, dass sich der Leitfaden [[Hilfe:Leitfaden_erstellen#Under_Construction|in Bearbeitung]] befindet (muss nach Fertigstellung entfernt werden)* [[Hilfe:Wiki#Strukturbespiel_einfsind einzuhalten.C3.BCgen|Strukturbeispiele]] in entsprechender Formatierung* ein [[#Typische_Gliederung_eines_Dokuments|Inhaltsverzeichnis]], das wie folgt strukturiert sein soll
Optional stehen folgende Funktion bereit:* Vergabe eines [[Hilfe:Leitfaden_erstellen#Benutzerdefinierter_Titel|benutzerdefinierten Titels]]* [[Hilfe:Leitfaden_erstellen#SEO|Suchmaschinenoptimierung]] Der textliche Teil eines Wiki Leitfadens, beinhaltet den eigentlichen Inhalt(/Beschreibung) eines Implementierungsleitfaden. Implementierungsleitfäden sind sehr lange Dokumente und umfassen meist eine Seitenanzahl von über 200 A4 Seiten. Deshalb ist es sinnvoll das Hauptdokument in Teildokumente zu unterteilen. Die Summe der Teildokumente ergibt somit einen Leitfaden.  Es Aufgrund bisherige Erfahrungen wird empfohlen, nur jene (allgemeinen) Textabschnitte in Teildokumente auszulagern, die aufgrund deren allgemeinen Inhalten auch zur Transklusion in andere Leitfäden verwendet werden könntenkönnen. Dies hat den Vorteil, das mit den Onboard-Mitteln des Wikis verschiedene Seiten-Versionen (über den Reiter "Versionsgeschichte") leichter verglichen werden können.
===Typische Gliederung eines Dokuments===
Um eine konsistente Vorgehensweise bei der Erstellung und Darstellung eines Implementierungsleitfadens zu gewährleisten, wird folgende (minimale) Struktur vorgegeben:Ein Leitfaden wird typischerweise in folgende Abschnitte gliedert: '''TODO REVIEW'''
* Informationen über dieses Dokument
** Allgemeines
** Referenzen
** Revisionsliste
 
===Hauptdokument===
Das Hauptdokument bildet den eigentlichen Leitfaden im Wiki ab und ist in verschiedene Abschnitte eingeteilt. Diese Abschnitte sind im Wiki sogenannten Teildokumente die in Summe den gesamten Leitfaden abbilden. Um die Teildokumente in das richtige Hauptdokument zu transkludieren, müssen diese einem bestimmten Namensbereich zugeordnet sein.
Teildokumente werden im Wiki folgendermaßen eingebunden: <br/>
<pre>ILF:Harmonisierung</pre>
 
===Teildokument===
Die Teildokumente enthalten den eigentlichen Text und müssen ebenfalls dem Namespace "ILF" zugeordnet.
== Schematische Template-Darstellung ==
3.869
Bearbeitungen

Navigationsmenü