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 Entwicklungs­projekt ist der Produkt­verantwortliche 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 Produkt­verantwortliche 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 Produkt­verantwortliche 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 Produkt­verantwortliche, Software-Experten oder Vertreter des Teams sind Autoren der Bausteine der für den Architekturentwurf.
  • Vertreter der Betriebsorganisation (engl. ops) und Vertreter Projekt­organisation (engl. DevOps) sind Autoren der Betriebsanweisungen.

Innerhalb der Bereiche der Produkt­dokumentation 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.