Das Glossar als fester Bestandteil eines Anforderungsdokumentes

„Das MT muss spritzwasserfest sein.“

Diese Anforderung ist ohne zusätzliche Erläuterung weder eindeutig noch verständlich. Was ist ein MT? Und was genau bedeutet spritzwasserfest?

Besonders in neu aufgesetzten, interdisziplinären Projekten, bei denen unterschiedliche Spezialisten mit ihren historisch gewachsenen Fachsprachen zum ersten Mal zusammenarbeiten, aber auch im alltäglichen Projektgeschäft geht oft aufgrund von Kommunikationsproblemen wertvolle Entwicklungszeit verloren.

Man redet aneinander vorbei, da der Einzelne bzw. ein Fachbereich Begrifflichkeiten verwendet, bei denen er davon ausgeht, dass alle Projektbeteiligten dasselbe Verständnis von ihnen haben. Missverständnisse entstehen, müssen erkannt und ausgeräumt werden. Kurzum: Man verliert sich in Grundlagendiskussionen, anstatt das eigentliche Projekt voranzutreiben.

Solche Diskussionen sind zeitraubend und können vermieden werden, indem man bereits im Vorfeld wichtige Begriffe und Abkürzungen in einem Glossar definiert. Damit verständigt man sich auf eine gemeinsame Begriffswelt und fördert die Kommunikation. Ein weiterer Vorteil eines Glossars ist, dass Begriffe, die einmal in einem Glossar definiert sind, in beliebig vielen Anforderungen verwendet werden können. Damit muss man diese Begriffe nicht wieder und wieder in der Anforderung selbst erklären und die Anforderungen jedes Mal ausformulieren.

Sinnvoll ist es daher, beim Start eines neuen Projekts einen separaten Workshop für die Erstellung eines Glossars abzuhalten. Je nach Größe des Projektteams nehmen daran alle Beteiligten bzw. ausgewählte Vertreter jeder Fachdisziplin teil. Es werden u.a. folgende Kategorien von Begriffen definiert und in einem Glossar dokumentiert:

• kontextspezifische Fachbegriffe
• Abkürzungen
• Synonyme (Mehrere Begriffe mit derselben Bedeutung, wie z.B. „Laptop“ und „Notebook“)
• Homonyme (Ein Begriff, der unterschiedliche Bedeutungen hat, wie z.B. das Wort „Bank“)
• alltägliche Begriffe, die im gegebenen Kontext eine spezifische Bedeutung haben

Eine initiale Begriffsdefinition reicht allerdings meist nicht aus, denn im Laufe des Projekts wird man auf weitere Fachbegriffe oder Abkürzungen stoßen, die noch nicht festgelegt wurden. Es muss also auch vereinbart werden, wie das Glossar gepflegt wird und wer das macht. Denn wird das Glossar nicht fortlaufend aktualisiert, so verliert es mit der Zeit an Wert.

Wichtig ist auch, dass das Glossar allen zugänglich ist, damit jeder Begriffe nachschlagen kann. Zudem kann dadurch jeder dem oder den Verantwortlichen des Glossars Vorschläge zu noch nicht im Glossar definierten Begriffen unterbreiten.

Ein Glossar kann wie folgt aussehen:

Die feste Integration eines Glossars beim Schreiben von Anforderungsdokumenten bedeutet zwar Mehraufwand, erhöht aber gleichzeitig merklich die Eindeutigkeit von Anforderungen und damit ihre Qualität – ein Anspruch, den jedes Unternehmen zur Verkürzung ihrer Entwicklungszeiten und zur Erreichung ihrer Entwicklungsziele hat.

Miriam Poethen

Kontaktieren Sie Miriam Poethen

Frau Miriam Poethen ist als Consultant im Bereich Requirements Engineering tätig. Ihre Tätigkeitsschwerpunkte liegen in der Unterstützung unserer Kunden beim Einsatz von Requirements Engineering und zugehöriger Werkzeuge. Zu ihren Aufgaben zählen die Erhebung, Verbesserung und Dokumentation von funktionalen und nicht-funktionalen Anforderungen, der Einsatz von verschiedenen Modellierungstechniken aus der UML sowie die Einführung integrierter Application Lifecycle Management Umgebungen in der Softwareentwicklung mittlerer und größerer Organisationen.