Das Prinzip SRP

Single responsibility principle

Nur ein Verantwortlicher

clean-code-developer

Das Prinzip SRP ver­wenden Autoren beim Doku­men­tie­ren anders als Ent­wick­ler beim Program­mie­ren. Autoren ver­wenden das Prin­zip im wört­lichen Sinne. In einem agilen Ent­wicklungs­projekt ist der Produkt­verant­wort­liche für alle Belange eines Pro­duk­tes verant­wort­lich. Aber eine Per­son allein kann für eine einiger­maßen kom­plexe Soft­ware nicht die gesamte Pro­duklt­doku­men­tation schreiben.

  • Der Produkt­verant­wort­liche und Ana­lysten oder Soft­ware-Exper­ten zu seiner Unter­stützung oder Ent­lastung sind Autoren der Bau­steine der System­beschrei­bung.
  • Ana­lysten oder Redak­teure, unter­stützt von ausge­wählten Nutzern als Domänen­exper­ten, sind Autoren der Hand­bücher und Online-Hil­fen.
  • Der Produkt­verant­wort­liche und Ana­lysten oder Soft­ware-Exper­ten zu seiner Unter­stützung oder Ent­lastung sind Autoren der Bau­steine der System­struk­tur. Ver­treter aus dem Team sind ver­ant­wort­lich für die Ver­öffent­lichung der Spezifi­kation in den Bau­steinen.
  • Der Produkt­verant­wort­liche, Soft­ware-Exper­ten oder Ver­treter des Teams sind Autoren der Bau­steine der für den Archi­tektur­ent­wurf.
  • Ver­treter der Betriebs­organi­sation (engl. ops) und Ver­treter Projekt­organi­sation (engl. DevOps) sind Autoren der Betriebs­anwei­sungen.

Inner­halb der Bereiche der Pro­dukt­doku­men­tation werden Autoren für den Inhalt jeder Seite im Wiki ein­deutig bestimmt. Mit Bereich ist dabei die Unter­schei­dung der Bau­steine für System­beschrei­bung, System­struk­tur und Archi­tektur­ent­wurf gemeint. Eine Seite im Wiki hat immer genau einen Autor. Er ist für den Inhalt der Seite ver­ant­wort­lich, bis sie fertig ist — gemäß einer vom Team verab­schiede­ten DOD.