cards+
Das Prinzip SRP
Nur ein Verantwortlicher Single responsibility principle

clean-code-developer

Das Prinzip SRP verwenden Autoren beim Dokumentieren anders als Entwickler beim Programmieren. Autoren verwenden das Prinzip im wörtlichen Sinne. In einem agilen Entwicklungsprojekt ist der Produktverantwortliche für alle Belange eines Produktes verantwortlich. Aber eine Person allein kann für eine einigermaßen komplexe Software nicht die gesamte Produkltdokumentation schreiben.

  • Der Produktverantwortliche und Analysten oder Software-Experten zu seiner Unterstützung oder Entlastung sind Autoren der Bausteine der Systembeschreibung.
  • Analysten oder Redakteure, unterstützt von ausgewählten Nutzern als Domänenexperten, sind Autoren der Handbücher und Online-Hilfen.
  • Der Produktverantwortliche und Analysten oder Software-Experten zu seiner Unterstützung oder Entlastung sind Autoren der Bausteine der Systemstruktur. Vertreter aus dem Team sind verantwortlich für die Veröffentlichung der Spezifikation in den Bausteinen.
  • Der Produktverantwortliche, Software-Experten oder Vertreter des Teams sind Autoren der Bausteine der für den Architekturentwurf.
  • Vertreter der Betriebsorganisation (engl. ops) und Vertreter Projektorganisation (engl. DevOps) sind Autoren der Betriebsanweisungen.

Innerhalb der Bereiche der Produktdokumentation werden Autoren für den Inhalt jeder Seite im Wiki eindeutig bestimmt. Mit Bereich ist dabei die Unterscheidung der Bausteine für Systembeschreibung, Systemstruktur und Architekturentwurf gemeint. Eine Seite im Wiki hat immer genau einen Autor. Er ist für den Inhalt der Seite verantwortlich, bis sie fertig ist — gemäß einer vom Team verabschiedeten DOD.