Methode
Motivation für den Einsatz
Richtlinien und Leitfäden sind ganz allgemein Zusammenstellungen abgestimmter Regeln. Sie sind sichtbarer Ausdruck der Qualitätspolitik einer Projektorganisation. Sie müssen immer greifbar und leicht verständlich geschrieben sein.
Für welche Themen überhaupt Richtlinie notwendig sind, hängt ganz entscheidende vom Projektumfeld ab. Die Anwendungsdomäne ist ein weiterer wichtiger Einflussfaktor.
Wissensmanagement richtig organisieren.
Zielgerichtet.
Agil.
Iterativ.
Prozesse
Projektmanagement
Richtlinien und Leitfäden regeln die Zusammenarbeit in der Projektorganisation. Es gibt sie in Form von unternehmensweit gültigen Vorgaben. Sie entstehen häufig aus Anforderungen aus dem Qualitätsmanagement oder sorgen für den Schutz von Informationen.
Prozesse
Anforderungsanalyse
Nationale und internationale Gesetze und Verordnungen, Industrienormen der DIN oder ISO, Industriestandards der Branchen und Vorgaben und Einschränkungen aus Verträgen müssen in der Anforderungsanalyse beachtet werden. Gesetze und Verordnungen werden aufgrund ihre speziellen Sprache von Rechtsanwälten in verständliche Regeln übersetzt. Industrienormen und -standards sind in der Regel sehr umfangreich. In einer Richtlinie wird ihr Umfang begrenzt. Nicht relevante Regeln werden ausgeschlossen – mit Begründung.
Prozesse
Produktentwicklung
Eine Gestaltungsrichtlinie (engl. style guide) regelt das Erscheinungsbild von Anwendungen. Teams einigen sich mit einer Programmierrichtlinie auf einen gemeinsame Art und Weise, wie sie Code schreiben. In Scrum definiert ein Team den Begriff Fertig (engl. definition of done) mit einer Richtlinie.
Seitenvorlagen für alle Bausteine und hilfreiche Makros für die Verwendung in Confluence.
Qualität
Seitenvorlage des Bausteins
Confluence unterstützt mit Seitenvorlagen die Idee der Bausteine optimal. Das folgende Beispiel kann direkt als HTML im Editor der Seitenvorlagen eingefügt werden.
Bitte hier Klicken, um den Quelltext anzuzeigen
<ac:layout> <ac:layout-section ac:type="two_equal"> <ac:layout-cell> <h1>Motivation</h1> <ac:structured-macro ac:name="excerpt" ac:schema-version="1"> <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter> <ac:rich-text-body> <p> <ac:placeholder>Hier bitte die Motivation einfügen. Bitte im Auszug die Kurzfassung. Weitere Beschreibungen und Abbildungen außerhalb des Auszugs in diesem Abschnitt einfügen.</ac:placeholder> </p> </ac:rich-text-body> </ac:structured-macro> </ac:layout-cell> <ac:layout-cell> <h1>Häufig gestellte Fragen</h1> <p> <ac:structured-macro ac:name="toc" ac:schema-version="1"> <ac:parameter ac:name="maxLevel">2</ac:parameter> <ac:parameter ac:name="minLevel">2</ac:parameter> </ac:structured-macro> </p> </ac:layout-cell> </ac:layout-section> <ac:layout-section ac:type="single"> <ac:layout-cell> <h1> <ac:placeholder>Hier bitte den Text einfügen.</ac:placeholder> </h1> </ac:layout-cell> </ac:layout-section> </ac:layout>
Struktur
Eigenschaften des Bausteins
Der Baustein Policy beschreibt Regeln in einem Frage-Antwort-Format. Das Format hat den Vorteil, dass eine bestehende Richtlinie leicht erweitert werden kann. Eine neue Frage fügt einen neuen Aspekt hinzu, ohne in der Regel andere Regeln dadurch zu beeinflusse. Das Format hat außerdem den Vorteil, dass wichtige Informationen punktgenau formuliert werden können. Es gibt sogar Fragen in einer Richtlinie, die einfach mit Ja oder Nein beantwortet werden.
Der Baustein Policy hat keinen Zustand. Mit der Veröffentlichung im Wiki ist er gültig.
Der Baustein Policy hat keinen Bezug zu einem Produktinkrement.
Der Baustein Policy wird in der Sprache der Organisation geschrieben.