Methode
Motivation für den Einsatz
Das Glossar ist ein Konzept, um Begriffe der Anwendungsdomäne, in der die Software zum Einsatz kommt, auf einer weitestgehend abstrakten Ebene zu erklären. Es ist das Wörterbuch für das Vokabular der gemeinsamen Sprache der interessierten Parteien und der Projektorganisation. Für jeden Begriff gibt es eines Seite im Wiki. Die Seiten sind alphabetisch sortiert. Ein Glossar ist darum ein Mini-Lexikon, zugeschnitten auf die Fähigkeiten der Software.
Ein Autor kann ganz leicht einen Begriff im Text seiner Seite im Wiki mit einem Eintrag im Glossar verknüpfen. Der Begriff wird als Verknüpfung automatisch hervorgehoben. Mit einem Klick sieht der Leser die Definition des Begriffes.
Wissensmanagement richtig organisieren.
Zielgerichtet.
Agil.
Iterativ.
Prozesse
Projektmanagement
Der Produktverantwortliche definiert mit dem Baustein wichtige Begriffe, die der Auftraggeber oder andere Domänenexperten bei Gesprächen verwenden. Die Begriffe beschreiben wichtige Elemente der Geschäftsprozesse im Unternehmen, in dem die Software zum Einsatz kommt. Die wichtigsten Objekte der Anwendungsdomäne werden identifiziert und werden als Begriff erklärt, ohne näher auf Details einzugehen.
Prozesse
Anforderungsanalyse
Der Produktverantwortliche definiert mit dem Baustein wichtige Begriffe, die bei der Analyse von Anforderungen wichtig sind. Diese Begriffe nutzt er konsequent beim Beschreiben der geforderten Fähigkeiten der Software. Damit legt der den Grundstein für die gemeinsame Sprache von interessierten Parteien und Projektorganisation.
Prozesse
Produktentwicklung
Jedes Produktinkrement erweitert das Produkt um mindestens eine neue Fähigkeit oder ändert eine bestehende. Mit Erweiterungen der Software sind immer auch neue Begriffe verbunden. Im Glossar kann sich ein Entwickler oder Tester jederzeit über einen Begriff informieren. Das beugt Missverständnissen vor. Ein Doppelbelegung eines Begriffs kann leichter verhindert werden.
Seitenvorlagen für alle Bausteine und hilfreiche Makros für die Verwendung in Confluence.
Qualität
Seitenvorlage des Bausteins
Confluence unterstützt mit Seitenvorlagen die Idee der Bausteine optimal. Das folgende Beispiel kann direkt als HTML im Editor der Seitenvorlagen eingefügt werden.
Bitte hier Klicken, um den Quelltext anzuzeigen
<ac:structured-macro ac:name="excerpt" ac:schema-version="1">
<ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
<ac:rich-text-body>
<p>
<ac:placeholder>Hier bitte die Definition für den Begriff einfügen.</ac:placeholder>
</p>
</ac:rich-text-body>
</ac:structured-macro>
Struktur
Eigenschaften des Bausteins
Der Baustein Term enthält die Definition eines Begriffes der Anwendungsdomäne.
Der Begriff wird immer zuerst aus der Sicht des Produktes erklärt.
Definitionen aus anderen Anwendungsdomänen für den gleichen Begriff können aber
ergänzt werden, müssen aber mit einer Quellenangabe eindeutig
gekennzeichnet werden.
Auch die Übersetzung des Begriffes in andere als die Sprache der Anwendungsdomäne ist
möglich, wenn es den Bedarf in der Projektorganisation gibt.
Der Seitentitel des Eintrags ist der Begriff in Normalform (also Singular, voll
ausgeschrieben) selbst, ohne weitere Zusätze.
Gibt es für den Begriff einen feste Abkürzung, dann wird sie an den Seitentitel in
runden Klammern angehängt.
Jeder Eintrag hat das Stichwort term und den Begriff selbst.
Dadurch wird der Eintrag leichter auffindbar.
Der Baustein Term hat keinen Zustand. Mit der Veröffentlichung im Wiki ist er gültig.
Der Baustein Term hat keinen Bezug zu einem Produktinkrement.
Der Baustein Term wird in der Sprache der interessierten Parteien geschrieben.