{"status":"ok","message-type":"work","message-version":"1.0.0","message":{"indexed":{"date-parts":[[2026,2,5]],"date-time":"2026-02-05T21:52:09Z","timestamp":1770328329653,"version":"3.49.0"},"reference-count":35,"publisher":"Springer Science and Business Media LLC","issue":"4","license":[{"start":{"date-parts":[[2023,7,1]],"date-time":"2023-07-01T00:00:00Z","timestamp":1688169600000},"content-version":"tdm","delay-in-days":0,"URL":"https:\/\/creativecommons.org\/licenses\/by\/4.0"},{"start":{"date-parts":[[2023,7,6]],"date-time":"2023-07-06T00:00:00Z","timestamp":1688601600000},"content-version":"vor","delay-in-days":5,"URL":"https:\/\/creativecommons.org\/licenses\/by\/4.0"}],"content-domain":{"domain":["link.springer.com"],"crossmark-restriction":false},"short-container-title":["Empir Software Eng"],"published-print":{"date-parts":[[2023,7]]},"abstract":"<jats:title>Abstract<\/jats:title><jats:sec>\n                <jats:title>Context<\/jats:title>\n                <jats:p>The management of <jats:italic>Interface Control Documents<\/jats:italic> (ICDs) has shown to be a major pain point in the architecting processes of <jats:italic>Systems of Systems<\/jats:italic> (SoS).<\/jats:p>\n              <\/jats:sec><jats:sec>\n                <jats:title>Objective<\/jats:title>\n                <jats:p>This 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.<\/jats:p>\n              <\/jats:sec><jats:sec>\n                <jats:title>Method<\/jats:title>\n                <jats:p>We 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.<\/jats:p>\n              <\/jats:sec><jats:sec>\n                <jats:title>Results<\/jats:title>\n                <jats:p>In-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.<\/jats:p>\n              <\/jats:sec><jats:sec>\n                <jats:title>Conclusions<\/jats:title>\n                <jats:p>The 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.<\/jats:p>\n              <\/jats:sec>","DOI":"10.1007\/s10664-023-10350-7","type":"journal-article","created":{"date-parts":[[2023,7,6]],"date-time":"2023-07-06T09:02:26Z","timestamp":1688634146000},"update-policy":"https:\/\/doi.org\/10.1007\/springer_crossmark_policy","source":"Crossref","is-referenced-by-count":4,"title":["Improving hardware\/software interface management in systems of systems through documentation as code"],"prefix":"10.1007","volume":"28","author":[{"ORCID":"https:\/\/orcid.org\/0000-0003-4965-4243","authenticated-orcid":false,"given":"H\u00e9ctor","family":"Cadavid","sequence":"first","affiliation":[],"role":[{"role":"author","vocabulary":"crossref"}]},{"given":"Vasilios","family":"Andrikopoulos","sequence":"additional","affiliation":[],"role":[{"role":"author","vocabulary":"crossref"}]},{"given":"Paris","family":"Avgeriou","sequence":"additional","affiliation":[],"role":[{"role":"author","vocabulary":"crossref"}]}],"member":"297","published-online":{"date-parts":[[2023,7,6]]},"reference":[{"key":"10350_CR1","doi-asserted-by":"crossref","unstructured":"Maier MW (1998) Architecting principles for systems-of-systems. Syst Eng J Int Council Syst Eng 1(4):267\u2013284","DOI":"10.1002\/(SICI)1520-6858(1998)1:4<267::AID-SYS3>3.0.CO;2-D"},{"key":"10350_CR2","unstructured":"ISO, IEC, (2019) 21839 information technology - systems and software engineering - system of systems (sos) considerations in life cycle stages of a system. Standard, International Organization for Standardization, Geneva, CH"},{"key":"10350_CR3","doi-asserted-by":"publisher","DOI":"10.1016\/j.infsof.2019.106202","volume":"118","author":"H Cadavid","year":"2020","unstructured":"Cadavid H, Andrikopoulos V, Avgeriou P (2020) Architecting systems of systems: A tertiary study. Inf Softw Technol 118:106202","journal-title":"Inf Softw Technol"},{"key":"10350_CR4","doi-asserted-by":"crossref","unstructured":"Cadavid H, Andrikopoulos V, Avgeriou P, Klein J (2020) A survey on the interplay between software engineering and systems engineering during sos architecting. In Proceedings of the 14th ACM \/ IEEE International Symposium on Empirical Software Engineering and Measurement (ESEM). ESEM \u201920. Association for Computing Machinery, New York, NY USA","DOI":"10.1145\/3382494.3410671"},{"key":"10350_CR5","doi-asserted-by":"crossref","unstructured":"Cadavid H, Andrikopoulos V, Avgeriou P, Broekema PC (2021) System- and software-level architecting harmonization practices for systems-of-systems : An exploratory case study on a long-running large-scale scientific instrument. In 2021 IEEE 18th International Conference on Software Architecture (ICSA), pp 13\u201324","DOI":"10.1109\/ICSA51549.2021.00010"},{"key":"10350_CR6","doi-asserted-by":"publisher","DOI":"10.1016\/j.infsof.2022.106984","volume":"150","author":"H Cadavid","year":"2022","unstructured":"Cadavid H, Andrikopoulos V, Avgeriou P, Broekema PC (2022) System and software architecting harmonization practices in ultra-large-scale systems of systems: A confirmatory case study. Inf Softw Technol 150:106984","journal-title":"Inf Softw Technol"},{"issue":"3","key":"10350_CR7","doi-asserted-by":"publisher","first-page":"62","DOI":"10.1002\/inst.12213","volume":"21","author":"S Sheard","year":"2018","unstructured":"Sheard S, Creel R, Cadigan J, Marvin J, Chim L, Pafford ME (2018) Incose working group addresses system and software interfaces. INSIGHT 21(3):62\u201371","journal-title":"INSIGHT"},{"key":"10350_CR8","doi-asserted-by":"crossref","unstructured":"Cadavid H, Andrikopoulos V, Avgeriou P (2022) Documentation-as-code for interface control document management in systems of systems: A technical action research study. In European Conference on Software Architecture, pp 19\u201337 Springer","DOI":"10.1007\/978-3-031-16697-6_2"},{"key":"10350_CR9","volume-title":"Docs Like Code","author":"A Gentle","year":"2017","unstructured":"Gentle A (2017) Docs Like Code. Lulu Press, Inc Morrisville, North Carolina"},{"key":"10350_CR10","first-page":"3","volume-title":"Future Observations of Cosmic Magnetic Fields with LOFAR, SKA and Its Precursors","author":"R Beck","year":"2015","unstructured":"Beck R (2015) In Lazarian A, de Gouveia Dal Pino EM. In: Melioli C (ed) Future Observations of Cosmic Magnetic Fields with LOFAR, SKA and Its Precursors. Springer, Berlin, Heidelberg, pp 3\u201317"},{"key":"10350_CR11","doi-asserted-by":"crossref","unstructured":"Firesmith D (2010) Profiling systems using the defining characteristics of systems of systems (sos)","DOI":"10.21236\/ADA515876"},{"issue":"1","key":"10350_CR12","doi-asserted-by":"publisher","first-page":"908","DOI":"10.1002\/pra2.2018.14505501171","volume":"55","author":"R Thomchick","year":"2018","unstructured":"Thomchick R (2018) Improving access to api documentation for developers with docs-as-code-as-a-service. Proceedings of the association for information science and technology 55(1):908\u2013910","journal-title":"Proceedings of the association for information science and technology"},{"key":"10350_CR13","doi-asserted-by":"crossref","unstructured":"Ozerova MI, Zhigalov IE, Vershinin VV (2020) Comparison of document generation algorithms using the docs-as-code approach and using a text editor. In Proceedings of the computational methods in systems and software, pp 315\u2013326 Springer","DOI":"10.1007\/978-3-030-63322-6_25"},{"key":"10350_CR14","unstructured":"Lambourne J (2017) Why we use a \u2019docs as code\u2019 approach for technical documentation. https:\/\/technology.blog.gov.uk\/2017\/08\/25\/why-we-use-a-docs-as-code-approach-for-technical-documentation\/"},{"issue":"3","key":"10350_CR15","doi-asserted-by":"publisher","first-page":"210","DOI":"10.1002\/spe.2770","volume":"50","author":"G Rong","year":"2020","unstructured":"Rong G, Jin Z, Zhang H, Zhang Y, Ye W, Shao D (2020) Devdocops: Enabling continuous documentation in alignment with devops. Softw Practice Exp 50(3):210\u2013226","journal-title":"Softw Practice Exp"},{"issue":"1","key":"10350_CR16","doi-asserted-by":"publisher","first-page":"73","DOI":"10.1504\/IJPLM.2011.038103","volume":"5","author":"K Rahmani","year":"2011","unstructured":"Rahmani K, Thomson V (2011) Managing subsystem interfaces of complex products. Int J Product Lifecycle Management 5(1):73","journal-title":"Int J Product Lifecycle Management"},{"key":"10350_CR17","first-page":"26","volume":"1250","author":"H Louadah","year":"2014","unstructured":"Louadah H, Champagne R (2014) Labiche Y. Towards automating interface control documents elaboration and management 1250:26\u201333","journal-title":"Towards automating interface control documents elaboration and management"},{"key":"10350_CR18","unstructured":"Harvey D, Waite M, Logan P, Liddy T (2012) Document the model, don\u2019t model the document. In Proc Syst Eng\/Test Eval Conf 6th Asia Pac Conf Syst Eng"},{"key":"10350_CR19","volume-title":"Modeling, systems engineering, and project management for astronomy VIII, pp 29 SPIE","author":"R Karban","year":"2018","unstructured":"Karban R, Troy M, Brack GL, Dekens FG, Michaels SB, Herzig S (2018) Verifying Interfaces and generating interface control documents for the alignment and phasing subsystem of the Thirty Meter Telescope from a system model in SysML. In: Angeli GZ, Dierickx P (eds) Modeling, systems engineering, and project management for astronomy VIII, pp 29 SPIE. Austin United States"},{"key":"10350_CR20","volume-title":"Software and Cyberinfrastructure for Astronomy V, pp 78 SPIE","author":"G Chiozzi","year":"2018","unstructured":"Chiozzi G, Andolfato L, Kiekebusch MJ, Kornweibel N, Schilling M, Zamparelli M (2018) Designing and managing software interfaces for the ELT. In: Guzman JC, Ibsen J (eds) Software and Cyberinfrastructure for Astronomy V, pp 78 SPIE. Austin United States"},{"key":"10350_CR21","doi-asserted-by":"crossref","unstructured":"Di\u00a0Maio M, Atorf L, Dahmen U, Schluse M, Rossmann J, Hoppe M, Kapos G-D (2018) Interface management with closed-loop systems engineering (CLOSE). In 2018 IEEE international systems engineering symposium (ISSE), pp 1\u20138","DOI":"10.1109\/ISSE43632.2018.9058620"},{"issue":"1","key":"10350_CR22","doi-asserted-by":"publisher","first-page":"1129","DOI":"10.1002\/j.2334-5837.2016.00216.x","volume":"26","author":"K Vipavetz","year":"2016","unstructured":"Vipavetz K, Shull TA, Infeld S, Price J (2016) Interface management for a NASA flight project using model-based systems engineering (MBSE). INCOSE Int Symposium 26(1):1129\u20131144","journal-title":"INCOSE Int Symposium"},{"key":"10350_CR23","doi-asserted-by":"crossref","unstructured":"Tsui R, Davis D, Sahlin J (2018) Digital engineering models of complex systems using model-based systems engineering (mbse) from enterprise architecture (ea) to systems of systems (sos) architectures & systems development life cycle (sdlc). In INCOSE international symposium, vol 28, pp 760\u2013776 Wiley Online Library","DOI":"10.1002\/j.2334-5837.2018.00514.x"},{"key":"10350_CR24","doi-asserted-by":"publisher","first-page":"187","DOI":"10.1016\/j.procir.2021.05.053","volume":"100","author":"S Japs","year":"2021","unstructured":"Japs S, Anacker H, Dumitrescu R (2021) Save: Security & safety by model-based systems engineering on the example of automotive industry. Procedia CIRP 100:187\u2013192","journal-title":"Procedia CIRP"},{"key":"10350_CR25","doi-asserted-by":"crossref","unstructured":"Wheatcraft LS (2010) 9.2. 2 everything you wanted to know about interfaces, but were afraid to ask. In INCOSE international symposium, vol 20, pp 1132\u20131149 Wiley Online Library","DOI":"10.1002\/j.2334-5837.2010.tb01130.x"},{"key":"10350_CR26","doi-asserted-by":"publisher","first-page":"353","DOI":"10.1007\/978-3-030-62136-0_19","volume-title":"Model-Based Engineering of Collaborative Embedded Systems","author":"M Broy","year":"2021","unstructured":"Broy M, B\u00f6hm W, Rumpe B (2021) Advanced systems engineering. Model-Based Engineering of Collaborative Embedded Systems. Springer, New York, NY, pp 353\u2013364"},{"key":"10350_CR27","doi-asserted-by":"crossref","unstructured":"Guo D, Zhang X, Zhang J, Li H (2020) An interface management approach for civil aircraft design. In International Conference on Aerospace System Science and Engineering, pp 435\u2013446 Springer","DOI":"10.1007\/978-981-33-6060-0_30"},{"key":"10350_CR28","doi-asserted-by":"publisher","first-page":"2","DOI":"10.1051\/0004-6361\/201220873","volume":"556","author":"MP van Haarlem","year":"2013","unstructured":"van Haarlem MP, Wise MW, Gunst A, Heald G, McKean JP, Hessels JW, de Bruyn AG, Nijboer R, Swinbank J, Fallows R et al (2013) Lofar: The low-frequency array. Astronomy & Astrophysics 556:2","journal-title":"Astronomy & Astrophysics"},{"key":"10350_CR29","doi-asserted-by":"publisher","DOI":"10.1016\/j.oceaneng.2019.106441","volume":"191","author":"SF Yasseri","year":"2019","unstructured":"Yasseri SF, Bahai H (2019) Interface and integration management for FPSOs. Ocean Eng 191:106441","journal-title":"Ocean Eng"},{"key":"10350_CR30","volume-title":"Software and Cyberinfrastructure for Astronomy IV, vol 9913, pp 99131","author":"AJ Borrowman","year":"2016","unstructured":"Borrowman AJ, Taylor P (2016) Can your software engineer program your PLC? In: Chiozzi G, Guzman JC (eds) Software and Cyberinfrastructure for Astronomy IV, vol 9913, pp 99131. WA International Society for Optics and Photonics, SPIE, Bellingham"},{"key":"10350_CR31","doi-asserted-by":"publisher","DOI":"10.1007\/978-3-662-43839-8","volume-title":"Design science methodology for information systems and software engineering","author":"RJ Wieringa","year":"2014","unstructured":"Wieringa RJ (2014) Design science methodology for information systems and software engineering. Springer, New York, NY"},{"key":"10350_CR32","first-page":"93","volume-title":"The Focus group method as an Empirical tool in software engineering","author":"J Kontio","year":"2008","unstructured":"Kontio J, Bragge J, Lehtola L (2008) In Shull F. In: Singer J, Sj\u00f8berg DIK (eds) The Focus group method as an Empirical tool in software engineering. Springer, London, pp 93\u2013116"},{"key":"10350_CR33","doi-asserted-by":"crossref","unstructured":"Petersen K, Gencel C, Asghari N, Baca D, Betz S (2014) Action research as a model for industry-academia collaboration in the software engineering context. In Proceedings of the 2014 international workshop on long-term industrial collaboration on software engineering, pp 55\u201362","DOI":"10.1145\/2647648.2647656"},{"key":"10350_CR34","doi-asserted-by":"publisher","DOI":"10.1002\/9781119535041","volume-title":"Systems engineering of software-enabled systems","author":"RE Fairley","year":"2019","unstructured":"Fairley RE (2019) Systems engineering of software-enabled systems. Wiley Online Library, River Street Hoboken, NJ"},{"key":"10350_CR35","doi-asserted-by":"crossref","unstructured":"Ralph P, Tempero E (2018) Construct validity in software engineering research and software metrics. In Proceedings of the 22nd International Conference on Evaluation and Assessment in Software Engineering 2018, pp 13\u201323","DOI":"10.1145\/3210459.3210461"}],"container-title":["Empirical Software Engineering"],"original-title":[],"language":"en","link":[{"URL":"https:\/\/link.springer.com\/content\/pdf\/10.1007\/s10664-023-10350-7.pdf","content-type":"application\/pdf","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/link.springer.com\/article\/10.1007\/s10664-023-10350-7\/fulltext.html","content-type":"text\/html","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/link.springer.com\/content\/pdf\/10.1007\/s10664-023-10350-7.pdf","content-type":"application\/pdf","content-version":"vor","intended-application":"similarity-checking"}],"deposited":{"date-parts":[[2023,9,27]],"date-time":"2023-09-27T09:20:23Z","timestamp":1695806423000},"score":1,"resource":{"primary":{"URL":"https:\/\/link.springer.com\/10.1007\/s10664-023-10350-7"}},"subtitle":[],"short-title":[],"issued":{"date-parts":[[2023,7]]},"references-count":35,"journal-issue":{"issue":"4","published-print":{"date-parts":[[2023,7]]}},"alternative-id":["10350"],"URL":"https:\/\/doi.org\/10.1007\/s10664-023-10350-7","relation":{},"ISSN":["1382-3256","1573-7616"],"issn-type":[{"value":"1382-3256","type":"print"},{"value":"1573-7616","type":"electronic"}],"subject":[],"published":{"date-parts":[[2023,7]]},"assertion":[{"value":"30 May 2023","order":1,"name":"accepted","label":"Accepted","group":{"name":"ArticleHistory","label":"Article History"}},{"value":"6 July 2023","order":2,"name":"first_online","label":"First Online","group":{"name":"ArticleHistory","label":"Article History"}},{"order":1,"name":"Ethics","group":{"name":"EthicsHeading","label":"Declarations"}},{"value":"the authors declared that they have no conflict of interest","order":2,"name":"Ethics","group":{"name":"EthicsHeading","label":"Conflicts of interest"}}],"article-number":"100"}}