Back to overview

First-class artifacts as building blocks for live in-IDE documentation

Type of publication Peer-reviewed
Publikationsform Proceedings (peer-reviewed)
Author Patkar Nitish, Chis Andrei, Stulova Nataliia, Nierstrasz Oscar,
Project Agile Software Assistance
Show all

Proceedings (peer-reviewed)

Title of proceedings 2022 IEEE International Conference on Software Analysis, Evolution and Reengineering (SANER)

Open Access

Type of Open Access Repository (Green Open Access)


A traditional round-trip engineering approach based on model transformations does not scale well to modern agile development environments where numerous artifacts are produced using a range of heterogeneous tools and technologies. To boost artifact connectivity and maintain their consistency, we propose to create and manage software-related artifacts as first-class entities directly in an integrated development environment (IDE). This approach has two advantages: (i) compared to employing separate tools, creating various artifacts directly within a development platform eliminates the necessity to recover trace links, and (ii) first-class artifacts can be composed into stakeholder-specific live document-artifacts. We detail and exemplify our approach in the Glamorous Toolkit IDE (henceforth, Glamorous toolkit), and discuss the results of a semi-structured pilot survey we conducted with practitioners and researchers to evaluate its usefulness in practice.