Reviewing with LemonTree
Reviewing models is an important part of ensuring the quality, consistency, and traceability of model changes. LemonTree supports a structured review process directly within the model comparison and merge workflow. Reviewers can mark individual elements as reviewed, add comments, and track the progress of the review.
1. How to use it
LemonTree allows users to review model changes directly during the diff and merge process. When comparing two model versions, reviewers can work through the impacted elements and diagrams and assess the changes individually.
A review status can be assigned to an element in several ways. In the impacted element or diagram lists, the reviewer can use the checkbox next to an element to mark it as reviewed. The same status can be managed in the Tree Browser. Users can also right-click an element to mark the selected element, or an entire subtree, as reviewed.
Reviewed elements are visually identified by a green bar. If all child elements have been reviewed but the parent itself has not, LemonTree indicates this intermediate state with an orange bar. This makes it easy to see which parts of a model have already been checked and which still require attention.
In addition to review statuses, LemonTree provides review comments. A reviewer can select an element in the model tree, right-click it, and choose Add Comment. The comment records the author, the comment itself, and the associated model element. Existing comments are indicated directly in the model tree, while the Comments toolbar provides an overview of all comments. Comments can also be changed, deleted, exported to an Enterprise Architect model or CSV file, copied to the clipboard, saved in a session, or imported from a CSV file.
A typical workflow is: the author modifies the model, a LemonTree comparison is created, the reviewer examines the changes and adds comments where necessary, and the author can make corrections if required. Once the review is approved, the models can be merged and a new baseline can be created.
2. Why to use it
LemonTree's review functionality provides more than a simple comparison of two model versions. It creates a structured way for teams to assess, discuss, and approve model changes.
Instead of reviewing an entire model without a clear indication of progress, reviewers can work element by element and explicitly record which parts have already been checked. This is particularly useful for large and complex Enterprise Architect models where many elements may have changed.
Review comments also provide a direct connection between feedback and the affected model element. Rather than documenting feedback separately in emails or external documents, reviewers can place their observations where they are relevant. This creates a more transparent review process and helps authors understand exactly which model element requires attention.
The review workflow can therefore support a controlled process from change → comparison → review → feedback → correction → approval → merge. This makes model reviews more consistent and easier to manage across teams.
3. Benefits for the user
Using LemonTree for reviews provides several practical benefits:
- Clear review progress: Visual review indicators make it immediately apparent which elements have been reviewed and which still need attention.
- Focused reviews: Reviewers can concentrate on the elements affected by a change instead of manually searching through the entire model.
- Direct feedback: Comments are attached to specific model elements, making feedback easier to understand and act upon.
- Better collaboration: Authors and reviewers have a structured mechanism for discussing and resolving model changes.
- Improved traceability: Review statuses and comments provide a record of what was examined and what feedback was given.
- Flexible documentation: Comments can be exported to an Enterprise Architect model or CSV file, copied to the clipboard, or transferred between LemonTree sessions.
- Safer model evolution: A defined review and approval process helps teams identify unwanted or incorrect changes before they are merged into the main model.
For the individual user, the key advantage is that reviewing becomes an integrated part of the model comparison workflow rather than a separate manual activity. LemonTree combines visibility of changes, review status, and contextual feedback in one environment, making model reviews more efficient, transparent, and manageable.
Überprüfung mit LemonTree
Die Überprüfung von Modellen ist ein wichtiger Bestandteil zur Gewährleistung der Qualität, Konsistenz und Rückverfolgbarkeit von Modelländerungen. LemonTree unterstützt einen strukturierten Überprüfungsprozess direkt innerhalb des Workflows zum Modellvergleich und zur Zusammenführung. Prüfer können einzelne Elemente als geprüft markieren, Kommentare hinzufügen und den Fortschritt der Überprüfung verfolgen.
1. So funktioniert es
LemonTree ermöglicht es Benutzern, Modelländerungen direkt während des Vergleichs- und Zusammenführungsprozesses zu prüfen. Beim Vergleich zweier Modellversionen können Prüfer die betroffenen Elemente und Diagramme durchgehen und die Änderungen einzeln bewerten.
Einem Element kann auf verschiedene Weise ein Prüfstatus zugewiesen werden. In den Listen der betroffenen Elemente oder Diagramme kann der Prüfer das Kontrollkästchen neben einem Element aktivieren, um es als geprüft zu markieren. Der gleiche Status kann auch im Baum-Browser verwaltet werden. Benutzer können auch mit der rechten Maustaste auf ein Element klicken, um das ausgewählte Element oder einen gesamten Teilbaum als geprüft zu markieren.
Geprüfte Elemente sind visuell durch einen grünen Balken gekennzeichnet. Wenn alle untergeordneten Elemente geprüft wurden, das übergeordnete Element selbst jedoch noch nicht, zeigt LemonTree diesen Zwischenzustand mit einem orangefarbenen Balken an. So lässt sich leicht erkennen, welche Teile eines Modells bereits überprüft wurden und welche noch Aufmerksamkeit erfordern.
Zusätzlich zu den Prüfstatus bietet LemonTree die Möglichkeit, Prüfkommentare hinzuzufügen. Ein Prüfer kann ein Element im Modellbaum auswählen, mit der rechten Maustaste darauf klicken und „Kommentar hinzufügen“ wählen. Der Kommentar erfasst den Verfasser, den Kommentar selbst und das zugehörige Modellelement. Vorhandene Kommentare werden direkt im Modellbaum angezeigt, während die Symbolleiste „Kommentare“ einen Überblick über alle Kommentare bietet. Kommentare können außerdem geändert, gelöscht, in ein Enterprise Architect-Modell oder eine CSV-Datei exportiert, in die Zwischenablage kopiert, in einer Sitzung gespeichert oder aus einer CSV-Datei importiert werden.
Ein typischer Arbeitsablauf sieht wie folgt aus: Der Autor ändert das Modell, es wird ein LemonTree-Vergleich erstellt, der Prüfer untersucht die Änderungen und fügt bei Bedarf Kommentare hinzu, und der Autor kann gegebenenfalls Korrekturen vornehmen. Sobald die Überprüfung genehmigt ist, können die Modelle zusammengeführt und eine neue Baseline erstellt werden.
2. Warum sollte man diese Funktion nutzen?
Die Überprüfungsfunktion von LemonTree bietet mehr als nur einen einfachen Vergleich zweier Modellversionen. Sie schafft einen strukturierten Rahmen, in dem Teams Modelländerungen bewerten, diskutieren und genehmigen können.
Anstatt ein gesamtes Modell ohne klare Fortschrittsanzeige zu überprüfen, können Prüfer Element für Element vorgehen und explizit festhalten, welche Teile bereits geprüft wurden. Dies ist besonders nützlich bei großen und komplexen Enterprise Architect-Modellen, bei denen sich möglicherweise viele Elemente geändert haben.
Überprüfungskommentare stellen zudem eine direkte Verbindung zwischen dem Feedback und dem betroffenen Modellelement her. Anstatt Feedback separat in E-Mails oder externen Dokumenten zu dokumentieren, können Prüfer ihre Anmerkungen direkt an der entsprechenden Stelle einfügen. Dies sorgt für einen transparenteren Überprüfungsprozess und hilft den Autoren, genau zu verstehen, welches Modellelement Aufmerksamkeit erfordert.
Der Überprüfungs-Workflow kann somit einen kontrollierten Prozess von Änderung → Vergleich → Überprüfung → Feedback → Korrektur → Freigabe → Zusammenführung unterstützen. Dadurch werden Modellüberprüfungen teamübergreifend konsistenter und einfacher zu verwalten.
3. Vorteile für den Nutzer
Die Verwendung von LemonTree für Überprüfungen bietet mehrere praktische Vorteile:
- Übersichtlicher Überprüfungsfortschritt: Visuelle Überprüfungsindikatoren machen sofort ersichtlich, welche Elemente bereits überprüft wurden und welche noch Aufmerksamkeit erfordern.
- Gezielte Überprüfungen: Prüfer können sich auf die von einer Änderung betroffenen Elemente konzentrieren, anstatt das gesamte Modell manuell durchsuchen zu müssen.
- Direktes Feedback: Kommentare werden an bestimmte Modellelemente angehängt, wodurch das Feedback leichter zu verstehen und umzusetzen ist.
- Bessere Zusammenarbeit: Autoren und Prüfer verfügen über einen strukturierten Mechanismus zur Diskussion und Klärung von Modelländerungen.
- Verbesserte Nachverfolgbarkeit: Überprüfungsstatus und Kommentare dokumentieren, was geprüft wurde und welches Feedback gegeben wurde.
- Flexible Dokumentation: Kommentare können in ein Enterprise Architect-Modell oder eine CSV-Datei exportiert, in die Zwischenablage kopiert oder zwischen LemonTree-Sitzungen übertragen werden.
- Sicherere Modellweiterentwicklung: Ein definierter Überprüfungs- und Genehmigungsprozess hilft Teams dabei, unerwünschte oder fehlerhafte Änderungen zu erkennen, bevor diese in das Hauptmodell übernommen werden.
Für den einzelnen Nutzer besteht der entscheidende Vorteil darin, dass die Überprüfung zu einem integrierten Bestandteil des Modellvergleichs-Workflows wird und nicht mehr als separate manuelle Tätigkeit durchgeführt werden muss. LemonTree vereint die Sichtbarkeit von Änderungen, den Überprüfungsstatus und kontextbezogenes Feedback in einer Umgebung und macht Modellüberprüfungen so effizienter, transparenter und übersichtlicher.