Dokumentation

Qualitätsrichtlinien und Prüfschritte

Definieren Sie, welche Arbeit bestanden werden muss, weisen Sie sie Projekten zu und ändern Sie sie sicher.

Eine Richtlinie ist ein benannter, versionsgesteuerter Satz von Qualitätsprüfungen. Richtlinien werden Projekten zugewiesen; die eigentlichen Prüfungen werden ausgeführt.

Zu den Konzepten – blockierend versus beratend, sowie zur Position der Prüfungen im Ablauf – lesen Sie Qualitätsprüfungen zuerst. Diese Seite behandelt die Verwaltung von ihnen.

Sie finden sie unter Qualität → Richtlinien.

Eine Richtlinie erstellen

Eine Richtlinie besteht aus einer Reihe von Prüfungen sowie der Angabe, ob ein Fehler zum Blockieren oder zur Beratung führt.

Die meisten Organisationen benötigen zwei oder drei Richtlinien, nicht eine pro Projekt:

  • eine strenge Richtlinie für Produktionsdienste
  • eine Standard- Richtlinie für den regulären Betrieb
  • gelegentlich eine einfache Richtlinie für interne Tools und Prototypen

Mehr als das kann niemand mehr nachvollziehen, welches Projekt welche Richtlinie verwendet.

Zuweisung zu Projekten

Ein Projekt nutzt jeweils eine Richtlinie. Ändern Sie diese in den Qualitätseinstellungen des Projekts.

Ein Projekt ohne explizite Richtlinie verwendet die Standardeinstellung Ihrer Organisation. Legen Sie diese Standardeinstellung auf Ihre Standard- Richtlinie fest, nicht auf die strengste – die strengste sollte gezielt ausgewählt werden.

Sichere Implementierung

Das typische Problem bei Prüfungen besteht nicht darin, dass sie zu schwach sind. Vielmehr führt eine wohlmeinende, blockierende Prüfung dazu, dass alle Aufgaben in der Organisation gleichzeitig gestoppt werden.

Ein sicherer Ablauf:

  1. Fügen Sie die Prüfung als beratend.
  2. Lassen Sie sie für ein bis zwei Wochen im echten Einsatz laufen. Lesen Sie, was sie meldet.
  3. Passen Sie sie anhand der gewonnenen Erkenntnisse an.
  4. Stufen Sie sie zur blockierenden Prüfung für ein Projekt hoch.
  5. Setzen Sie sie anschließend breiter ein, sobald sie zuverlässig funktioniert.

Versionsverwaltung und Rollback

Richtlinien werden versionsgesteuert. Beim Veröffentlichen entsteht eine neue Version; Sie können auf eine frühere zurückgreifen.

Der Rollback ist der Grund, warum Sie beim Veröffentlichen entschlossen vorgehen können. Falls eine neue Prüfung falsch konfiguriert ist, lässt sich mit einem einzigen Klick zur vorherigen Version zurückkehren – statt mühsam nachzuforschen.

Überschreibungen

Eine blockierende Prüfung kann von einer berechtigten Person überschrieben werden. Die Überschreibung wird dokumentiert – wer, wann und gegenüber welcher Regel.

Beobachten Sie die Häufigkeit der Überschreibungen. Eine Prüfung, die bei jedem Auslösen überschrieben wird, hat keine Durchsetzungskraft mehr; sie erzeugt nur Reibung und unnötige Dokumentation. Entweder korrigieren Sie die Prüfung oder streichen Sie sie.