Trennung der Zuständigkeiten Separation of concerns

— — 

clean-code-developer

Das Prinzip SOC spiegelt sich in der Struktur der Seiten im Wiki wider. In den Bausteinen unterscheiden Autoren fachliche von technischen Belangen dort, wo es Sinn macht. Das Ziel ist es, bei der Arbeit im Wiki die Stärken der Autoren in ihren unterschiedlichen Rollen im agilen Entwicklungsprozess zu fördern. Das macht eine nachvollziehbare Aufteilung der Inhalte notwendig.

In vielen Fällen analysieren Autoren den Problemraum «top down», d.h. sie erforschen das «big picture», identifizieren neue Fähigkeiten für das Produkt. Das ist ein Prozess, den die Struktur und die Bausteine der Systembeschreibung berücksichtigen.

Interessierte Parteien (z.B. Auftraggeber, Nutzer als Domänenexperten) oder der Produkt­verantwortliche können ihr fundamentales Wissen über die Unter­nehmens­prozesse und die Bedürfnisse der Fachabteilungen gut einbringen, wenn das Abstraktions­niveau im Baustein passt. Interessierte Parteien arbeiten direkt und ohne Kommunikations­verluste im Wiki und sind dadurch auch für bestimmte Inhalte (z.B. im Bau­stein Topic) verantwortlich. Der Produkt­verantwortliche kann damit sicherstellen, dass sie die Probleme der interessierten Parteien richtig verstehen.

Der Produkt­verantwortliche oder interessierte Parteien sind als Leser aber oft überfordert, wenn sie technische Lösungen verstehen sollen. Ein Autor muss bei der Beschreibung der Essenzschritte im Baustein Case darauf achten, dass er nicht in Implementierungsdetails abgleitet. Er muss sich darauf beschränken, in den Essenzschritten der Lösung die richtige Verknüpfung zu den Bausteinen der Systemstruktur herzustellen.

In den Bausteinen der Systembeschreibung konzentrieren Autoren sich darum auf den Problemraum des Produktes. Auf die Nutzersicht. Die Beschreibung in einem Baustein orientiert sich an den Fähigkeiten der Software. Der Text ist in der Sprache der interessierten Parteien geschrieben.

Manche Entwickler sind ganz schlecht darin, die grundlegenden Bedürfnisse der Nutzer zu erkennen. Was für einen Nutzer einen großes Problem in der Verwendung des Produktes darstellt, ist für einen Entwickler oft nur eine Kleinigkeit bei der Realisierung. Auf der anderen Seite sehen Entwickler bei technischen Schulden oft großen Handlungsbedarf, den ein Nutzer nicht erkennen kann. Die Einschätzung der Wichtigkeit ist darum sehr unterschiedlich.

Die Bausteine der Systemstruktur orientieren sich ganz klar an der Software. Sie sind praktisch ein Abbild der Software im Wiki. Die Autoren konzentrieren sich auf den Lösungsraum des Produktes. Die Beschreibung in einem Baustein orientiert sich an den Diensten und Objekten des IT-Systems. Der Text ist in der Sprache der Entwickler und Tester geschrieben.