Improving hardware/software interface management in systems of systems through documentation as code

doi:10.1007/s10664-023-10350-7

2023-07-06

Héctor Cadavid *

Vasilios Andrikopoulos

Paris Avgeriou

DOI：10.1007/s10664-023-10350-7

原文链接

原文求助

摘要

En 中文

ContextThe management of Interface Control Documents (ICDs) has shown to be a major pain point in the architecting processes of Systems of Systems (SoS).ObjectiveThis work aims to improve on previously identified ICD management issues using the documentation-as-code philosophy as a potential basis for a treatment, and in collaboration with practitioners.MethodWe conducted a Technical Action Research (TAR) study with a group of engineers at the Netherlands Radio Astronomy Institute (ASTRON), in the context of the LOFAR radio telescope. An additional research instrument, in the form of an expert panel, was used to evaluate the transferability of the proposed treatment to alternative domains.ResultsIn-depth insights on previously identified interface management issues were gained. Based on these insights a functional proof-of-concept was developed aimed at addressing these issues following the documentation-as-code principles. In addition to receiving overall positive reviews from practitioners and experts, further areas of improvement and transferability considerations for future work were identified.ConclusionsThe proposed approach, which to our knowledge has not been explored before in this context, is promising to address some of the recurring interfacing-related issues with directed SoS in multiple engineering domains. This could be done mainly by enforcing consistency and completeness on both text-based and formal elements of the ICDs, and turning ICDs into single sources of truth for the architecting processes of large scale SoS.

Keyword:

System of systems

Interface control document

Documentation as code

Technical action research

期刊

Empirical Software Engineering

IF:

3.6

论文数:

2.0K

被引数:

5.3K

机构

University of Groningen

学者数:

4.4W

论文数: 4.3W

被引数: 5.9W

引用论文

LOFAR: The LOw-Frequency ARray LOFAR: 低频阵列

ASTRONOMY & ASTROPHYSICS

IF5.8

2013-07-16

1.7K

OAAI

van Haarlem, M. P.; Wise, M. W.; Gunst, A. W.; Heald, G.; McKean, J. P.; Hessels, J. W. T.; de Bruyn, A. G.; Nijboer, R.; Swinbank, J.; Fallows, R.; Brentjens, M.; Nelles, A.; Beck, R.; Falcke, H.; Fender, R.; Horandel, J.; Koopmans, L. V. E.; Mann, G.; Miley, G.; Rottgering, H.; Stappers, B. W.; Wijers, R. A. M. J.; Zaroubi, S.; van den Akker, M.; Alexov, A.; Anderson, J.; Anderson, K.; van Ardenne, A.; Arts, M.; Asgekar, A.; Avruch, I. M.; Batejat, F.; Bahren, L.; Bell, M. E.; Bell, M. R.; van Bemmel, I.; Bennema, P.; Bentum, M. J.; Bernardi, G.; Best, P.; Birzan, L.; Bonafede, A.; Boonstra, A. -J.; Braun, R.; Bregman, J.; Breitling, F.; van de Brink, R. H.; Broderick, J.; Broekema, P. C.; Brouw, W. N.; Brueggen, M.; Butcher, H. R.; van Cappellen, W.; Ciardi, B.; Coenen, T.; Conway, J.; Coolen, A.; Corstanje, A.; Damstra, S.; Davies, O.; Deller, A. T.; Dettmar, R. -J.; van Diepen, G.; Dijkstra, K.; Donker, P.; Doorduin, A.; Dromer, J.; Drost, M.; van Duin, A.; Eisloeffel, J.; van Enst, J.; Ferrari, C.; Frieswijk, W.; Gankema, H.; Garrett, M. A.; de Gasparin, F.; Gerbers, M.; de Geus, E.; Griessmeier, J. -M.; Grit, T.; Gruppen, P.; Hamaker, J. P.; Hassall, T.; Hoeft, M.; Holties, H. A.; Horneffer, A.; van der Horst, A.; van Houwelingen, A.; Huijgen, A.; Iacobelli, M.; Intema, H.; Jackson, N.; Jelic, V.; de Jong, A.; Kant, D.; Karastergiou, A.; Koers, A.; Kollen, H.; Kondratiev, V. I.; Kooistra, E.; Koopman, Y.; Koster, A.; Kuniyoshi, M.; Kramer, M.; Kuper, G.; Lambropoulos, P.; Law, C.; van Leeuwen, J.; Lemaitre, J.; Loose, M.; Maat, P.; Macario, G.; Markoff, S.; Masters, J.; McFadden, R. A.; McKay-Bukowski, D.; Meijering, H.; Meulman, H.; Mevius, M.; Millenaar, R.; Miller-Jones, J. C. A.; Mohan, R. N.; Mol, J. D.; Morawietz, J.; Morganti, R.; Mulcahy, D. D.; Mulder, E.; Munk, H.; Nieuwenhuis, L.; van Nieuwpoort, R.; Noordam, J. E.; Norden, M.; Noutsos, A.; Offringa, A. R.; Olofsson, H.; Omar, A.; Orru, E.; Overeem, R.; Paas, H.; Pandey-Pommier, M.; Pandey, V. N.; Pizzo, R.; Polatidis, A.; Rafferty, D.; Rawlings, S.; Reich, W.; de Reijer, J. -P.; Reitsma, J.; Renting, G. A.; Riemers, P.; Rol, E.; Romein, J. W.; Roosjen, J.; Ruiter, M.; Scaife, A.; van der Schaaf, K.; Scheers, B.; Schellart, P.; Schoenmakers, A.; Schoonderbeek, G.; Serylak, M.; Shulevski, A.; Sluman, J.; Smirnov, O.; Sobey, C.; Spreeuw, H.; Steinmetz, M.; Sterks, C. G. M.; Stiepel, H. -J.; Stuurwold, K.; Tagger, M.; Tang, Y.; Tasse, C.; Thomas, I.; Thoudam, S.; Toribio, M. C.; van der Tol, B.; Usov, O.; van Veelen, M.; van der Veen, A. -J.; ter Veen, S.; Verbiest, J. P. W.; Vermeulen, R.; Vermaas, N.; Vocks, C.; Vogt, C.; de Vos, M.; van der Wal, E.; van Weeren, R.; Weggemans, H.; Weltevrede, P.; White, S.; Wijnholds, S. J.; Wilhelmsson, T.; Wucknitz, O.; Yatawatta, S.; Zarka, P.; Zensus, A.; van Zwieten, J.

Accounting for crime in the US: Race, class and the spectacle of fear

Critical Perspectives on Accounting

IF0

2018-10-01

PREAI

Cheryl R. Lehman; Theresa Hammond; Gloria Agyemang

Subpicosecond Exciton Dynamics and Biexcitonic Feature in Colloidal CuInS₂ Nanocrystals: Role of In–Cu Antisite Defects

The Journal of Physical Chemistry Letters

IF0

2015-08-19

PREAI

Tushar Debnath; Sourav Maiti; Partha Maity; Hirendra N. Ghosh

Cortical activation pattern during saccadic eye movements in humans: Localization by focal cerebral blood flow increases

Annals of Neurology

IF0

2004-10-07

PREAI

Eldad Melamed; Bo Larsen

New Antibiotics Miyakamides Produced by a Fungus.

The Journal of Antibiotics

IF0

2002-01-01

OAAI

KAZURO SHIOMI; KENJI HATAE; YUICHI YAMAGUCHI; ROKURO MASUMA; HIROSHI TOMODA; SUSUMU KOBAYASHI; SATOSHI OMURA

Review on non-dipole effects in ionization and harmonic generation of atoms and molecules*

Chinese Physics B

IF0

2020-01-01

PREAI

Mu-Xue Wang; Si-Ge Chen; Hao Liang; Liang-You Peng

Distribution of gastrin-releasing peptide/bombesin-like immunoreactive cell bodies and fibres in the brainstem of the cat

Neuropeptides

IF0

1994-02-01

PREAI

P. Marcos; R. Coveñas; J.A. Narváez; G. Tramu; J.A. Aguirre; S. González-Barón

IF0

PREAI

Architecting systems of systems: A tertiary study

INFORMATION AND SOFTWARE TECHNOLOGY

IF4.3

2020-02-01

OAAI

Cadavid, Hector; Andrikopoulos, Vasilios; Avgeriou, Paris

Pseudouridylation of tRNA-Derived Fragments Steers Translational Control in Stem Cells

Cell

IF0

2018-05-01

OAAI

Nicola Guzzi; Maciej Cieśla; Phuong Cao Thi Ngoc; Stefan Lang; Sonali Arora; Marios Dimitriou; Kristyna Pimková; Mikael N.E. Sommarin; Roberto Munita; Michal Lubas; Yiting Lim; Kazuki Okuyama; Shamit Soneji; Göran Karlsson; Jenny Hansson; Göran Jönsson; Anders H. Lund; Mikael Sigvardsson; Eva Hellström-Lindberg; Andrew C. Hsieh; Cristian Bellodi

查看更多内容