Files
productmodel/OMDSServiceDefinition/ReleaseReadMe.md

47 lines
1.4 KiB
Markdown
Raw Normal View History

# Schritte beim Release einer neuen Version
## Bearbeitung der Norm
Abgrenzung des Veröffentlichungsumfangs - nicht alles aus dem Development-Branch wird veröffentlicht.
Insbesondere ist hier um etwaige Fehler auszuschließen nochmals gegen die tatsächlich veröffentlichten XSDs der
letzten Veröffentlichung zu prüfen.
Anpassung der Versions-Tags im in den XSDs und den Kommentar im WSDL.
## Code-Generierung
Der Code für die neue Version ist einmalig mit Java zu generieren.
Es gibt dazu ein Maven-Target.
## Überarbeitung der Dokumentation
Dokumente haben einen Kopf bestehend aus:
* Titel
* Status: Empfehlung, Vorgeschlagener oder Freigegebener Standard
* Release: Versionsnummer des Releases
* Ansprechpartner
* Dokumentenhistorie
* Voraussetzungen
* Rechtliche Hinweise
* Inhaltsverzeichnis
Dokumente sollen im Kopf die Versionsnummer tragen, damit der Leser
gleich erkennen kann, zu welcher Version das Dokument gehört.
Der Dokumentenstatus sollte im Kopf enthalten sein.
Entwürfe werden nicht veröffentlicht, sondern
* Empfehlung
* Vorgeschlagener Standard (min. 1. Implementierung)
* Freigegebener Standard (min. 2. Implementierungen)
In der Fußzeile findet sich ein Copyright Hinweis, der ggf. aktualisiert werden sollte.
## Generierung der XSD Dokumentation mit XmlSpy
# Build
In der Datei assembly.xml ist vogegeben, welche Verzeichnisse für die Veröffentlichung zusammengepackt werden.
Hier ist die Versionsnummmer des Release anzupassen!