Document toolboxDocument toolbox

0.1 Entwicklung einer Spezifikation

In dem Projekt "StöberSpecs" innerhalb des Kompetenzzentrums Interoparble Metadaten wurden Konzepte und Tools entwickelt, die die Erstellung von Metadatenprofilen ermöglichen. Dabei werden grundsätzlich verschiedene offene Tools empfohlen, die sich auf folgende Aspekte beziehen:

Außerdem wird ein Arbeitsprozess dargestellt und empfohlen, der bei der Erarbeitung einer Spezifikation unterstützen soll. Im folgenden wird kurz das Werkzeug zur Erarbeitung einer Spezifikation dargestellt. Genauere Informationen, auch zu den anderen Tools, können der README des "StöberSpecs" Repositories entnommen werden. 

Inhalt dieser Seite


Mitwirkende an dieser Seite:

UserEditsCommentsLabels
Das Luka 100


Spezifikationen, Standards, Empfehlungen

Die Erarbeitung einer Spezifikation wird als HTML/Markdown -Dokument empfohlen. Dieses Dokument kann einfach auf GitHub gemeinsam von einer Gruppe über einen geordneten und nachvollziehbaren Prozess bearbeitet und veröffentlicht werden.

Um dem Dokument einen offiziellen Charakter zu verleihen, kann ein ReSpec-Präprozessor genutzt werden, der die HTML-Datei in eine ordentliche Spezifikation verwandelt. Hier ein Beispiel, wie aus dem HTML/Markdown Dokument eine entsprechende Spezifikation inklusive Inhaltsverzeichnis generiert wird:




Dieses Tool wird bereits bei folgenden Spezifikationen eingesetzt: