Please use this identifier to cite or link to this item:
Main Title: What is a good textual representation of activity diagrams in requirements documents?
Author(s): Beckmann, Martin
Vogelsang, Andreas
Type: Conference Object
Language Code: en
Abstract: The use of graphical models has become a widely adopted approach to specify requirements of complex systems. Still, in practice, graphical models are often accompanied by textual descriptions to provide more detail, because of legal considerations, and to enable stakeholders with different backgrounds to understand a requirements document. One of our industry partners (Daimler AG) uses activity diagrams to specify vehicle functions in combination with a textual representation thereof in their requirements documents. Since graphical and textual representations serve different purposes, it is not obvious how textual representations of activity diagrams should be structured. In this paper, we present different textual representations of activity diagrams for use in requirements documents. The representation currently in use is presented as well as four alternatives. For each representation, we discuss advantages and disadvantages. To evaluate the representations, we asked five stakeholders of one system to create a preference ranking of the representations. The resulting ranking showed that the currently used representation is not considered to be the best possible option. The stakeholders’ favorite textual representation emphasizes structural similarity with the activity diagram, which however does not resemble the diagram’s structure exactly.
Issue Date: 2017
Date Available: 28-Mar-2018
DDC Class: 004 Datenverarbeitung; Informatik
Subject(s): UML Activity Diagrams
textual representation
Proceedings Title: Requirements Engineering Conference Workshops (REW), 2017 IEEE 25th International
Publisher: IEEE
Publisher Place: New York
Publisher DOI: 10.1109/REW.2017.19
Page Start: 56
Page End: 63
ISBN: 978-1-5386-3488-2
Appears in Collections:FG IT-basierte Fahrzeuginnovationen » Publications

Files in This Item:
File Description SizeFormat 
document.pdf609.99 kBAdobe PDFThumbnail

Items in DepositOnce are protected by copyright, with all rights reserved, unless otherwise indicated.