{"status":"ok","message-type":"work","message-version":"1.0.0","message":{"indexed":{"date-parts":[[2024,6,4]],"date-time":"2024-06-04T17:15:03Z","timestamp":1717521303802},"reference-count":30,"publisher":"Walter de Gruyter GmbH","issue":"8","license":[{"start":{"date-parts":[[2023,8,1]],"date-time":"2023-08-01T00:00:00Z","timestamp":1690848000000},"content-version":"unspecified","delay-in-days":0,"URL":"http:\/\/creativecommons.org\/licenses\/by\/4.0"}],"content-domain":{"domain":[],"crossmark-restriction":false},"short-container-title":[],"published-print":{"date-parts":[[2023,8,28]]},"abstract":"<jats:title>Abstract<\/jats:title>\n               <jats:p>This paper first examines the current state of industrial practice of documentation in automated production systems based on a large-scale survey in machine and plant manufacturing proving that companies still face major challenges in documentation. However, insufficient documentation creates friction since it may increase the risk of malfunction and high costs, and impede system development due to lack of traceability, especially for control software being one of the main functionality carriers. Therefore, secondly, a risk priority indicator RPI4DD is proposed to systematically capture the lack of control code documentation to avoid undesired costs due to inadequate documentation.<\/jats:p>","DOI":"10.1515\/auto-2022-0146","type":"journal-article","created":{"date-parts":[[2023,6,20]],"date-time":"2023-06-20T03:40:38Z","timestamp":1687232438000},"page":"670-689","source":"Crossref","is-referenced-by-count":1,"title":["Semi-automatic assessment of lack of control code documentation in automated production systems"],"prefix":"10.1515","volume":"71","author":[{"given":"Quang Huan","family":"Dong","sequence":"first","affiliation":[{"name":"Institute of Automation and Information Systems, Department of Mechanical Engineering, TUM School of Engineering and Design , Technical University of Munich , Munich , Germany"},{"name":"Vietnamese-German University , Thu Dau Mot City , Vietnam"}],"role":[{"role":"author","vocabulary":"crossref"}]},{"given":"Birgit","family":"Vogel-Heuser","sequence":"additional","affiliation":[{"name":"Institute of Automation and Information Systems, Department of Mechanical Engineering, TUM School of Engineering and Design , Technical University of Munich , Munich , Germany"},{"name":"Core Member of MDSI and Lead of Sector Work of MIRMI , Technical University of Munich , Munich , Germany"},{"name":"Munich Institute of Integrated Materials, Energy and Process Engineering , Technical University of Munich , Garching , Germany"}],"role":[{"role":"author","vocabulary":"crossref"}]},{"given":"Eva-Maria","family":"Neumann","sequence":"additional","affiliation":[{"name":"Institute of Automation and Information Systems, Department of Mechanical Engineering, TUM School of Engineering and Design , Technical University of Munich , Munich , Germany"}],"role":[{"role":"author","vocabulary":"crossref"}]}],"member":"374","published-online":{"date-parts":[[2023,8,8]]},"reference":[{"key":"2024011813340278183_j_auto-2022-0146_ref_001","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser and F. Ocker, \u201cMaintainability and evolvability of control software in machine and plant manufacturing \u2013 an industrial survey,\u201d Control Eng. Pract., vol.\u00a080, pp.\u00a0157\u2013173, 2018. https:\/\/doi.org\/10.1016\/j.conengprac.2018.08.007.","DOI":"10.1016\/j.conengprac.2018.08.007"},{"key":"2024011813340278183_j_auto-2022-0146_ref_002","doi-asserted-by":"crossref","unstructured":"A. L\u00fcder, A. Klostermeyer, J. Peschke, A. Bratoukhine, and T. Sauter, \u201cDistributed automation: pabadis versus hms,\u201d IEEE Trans. Industr. Inform., vol.\u00a01, no.\u00a03, pp.\u00a031\u201338, 2005. https:\/\/doi.org\/10.1109\/tii.2005.843825.","DOI":"10.1109\/TII.2005.843825"},{"key":"2024011813340278183_j_auto-2022-0146_ref_003","doi-asserted-by":"crossref","unstructured":"Q. H. Dong and B. Vogel-Heuser, \u201cModelling technical compromises in electronics manufacturing with BPMN+TD \u2013 an industrial use case,\u201d in IFAC-PapersOnLine: 17th IFAC Symposium on Information Control Problems in Manufacturing, vol.\u00a054, 2021, pp.\u00a0912\u2013917.","DOI":"10.1016\/j.ifacol.2021.08.108"},{"key":"2024011813340278183_j_auto-2022-0146_ref_004","doi-asserted-by":"crossref","unstructured":"V. Vyatkin, \u201cSoftware engineering in industrial automation: state-of-the-art review,\u201d IEEE Trans. Industr. Inform., vol.\u00a09, no.\u00a03, pp.\u00a01234\u20131249, 2013. https:\/\/doi.org\/10.1109\/tii.2013.2258165.","DOI":"10.1109\/TII.2013.2258165"},{"key":"2024011813340278183_j_auto-2022-0146_ref_005","doi-asserted-by":"crossref","unstructured":"J. Fischer, B. Vogel-Heuser, H. Schneider, N. Langer, M. Felger, and M. Bengel, \u201cMeasuring the overall complexity of graphical and textual iec 61131-3 control software,\u201d IEEE Robot. Autom. Lett., vol.\u00a09, no.\u00a03, pp.\u00a05784\u20135791, 2021. https:\/\/doi.org\/10.1109\/lra.2021.3084886.","DOI":"10.1109\/LRA.2021.3084886"},{"key":"2024011813340278183_j_auto-2022-0146_ref_006","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, S. R\u00f6sch, A. Martini, and M. Tichy, \u201cTechnical debt in automated production systems,\u201d in IEEE 7th Workshop on Managing Technical Debt, 2015, pp.\u00a049\u201352.","DOI":"10.1109\/MTD.2015.7332624"},{"key":"2024011813340278183_j_auto-2022-0146_ref_007","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, E.-M. Neumann, and J. Fischer, \u201cMaturity levels for automation software engineering in automated production systems,\u201d in 2022 IEEE International Conference on Industrial Informatics, 2022, pp.\u00a0618\u2013623.","DOI":"10.1109\/INDIN51773.2022.9976112"},{"key":"2024011813340278183_j_auto-2022-0146_ref_008","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, A. Fay, I. Schaefer, and M. Tichy, \u201cEvolution of software in automated production systems: challenges and research directions,\u201d J. Syst. Softw., vol.\u00a0110, pp.\u00a054\u201384, 2015. https:\/\/doi.org\/10.1016\/j.jss.2015.08.026.","DOI":"10.1016\/j.jss.2015.08.026"},{"key":"2024011813340278183_j_auto-2022-0146_ref_009","unstructured":"MISRA, MISRA, [Online], Available at: www.misra.org.uk [accessed: Oct. 26, 2022]."},{"key":"2024011813340278183_j_auto-2022-0146_ref_010","unstructured":"ISPE, GAMP 5 Guide: Compliant GxP Computerized Systems, [Online], Available at: https:\/\/ispe.org\/publications\/guidance-documents\/gamp-5 [accessed: Oct. 26, 2022]."},{"key":"2024011813340278183_j_auto-2022-0146_ref_011","doi-asserted-by":"crossref","unstructured":"T. Besker, A. Martini, and J. Bosch, \u201cSoftware developer productivity loss due to technical debt\u2014a replication and extension study examining developers\u2019 development work,\u201d J. Syst. Softw., vol.\u00a0156, pp.\u00a041\u201361, 2019. https:\/\/doi.org\/10.1016\/j.jss.2019.06.004.","DOI":"10.1016\/j.jss.2019.06.004"},{"key":"2024011813340278183_j_auto-2022-0146_ref_012","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, E. Neumann, and J. Fischer, \u201cMICOSE4aPS: industrially applicable maturity metric to improve systematic reuse of control software,\u201d ACM Trans. Softw. Eng. Methodol., vol.\u00a031, no.\u00a01, pp.\u00a01\u201324, 2022. https:\/\/doi.org\/10.1145\/3467896.","DOI":"10.1145\/3467896"},{"key":"2024011813340278183_j_auto-2022-0146_ref_013","doi-asserted-by":"crossref","unstructured":"J. Wilch, J. Fischer, N. Langer, M. Felger, M. Bengel, and B. Vogel-Heuser, \u201cTowards automatic generation of functionality semantics to improve PLC software modularisation,\u201d At \u2013 Automatisierungstechnik, vol.\u00a070, no.\u00a02, pp.\u00a0181\u2013191, 2022. https:\/\/doi.org\/10.1515\/auto-2021-0138.","DOI":"10.1515\/auto-2021-0138"},{"key":"2024011813340278183_j_auto-2022-0146_ref_014","doi-asserted-by":"crossref","unstructured":"T. Besker, A. Martini, J. Bosch, and M. Tichy, \u201cAn investigation of technical debt in automatic production systems,\u201d in Proceedings of the XP2017 Scientific Workshops, 2017, pp.\u00a01\u20137.","DOI":"10.1145\/3120459.3120466"},{"key":"2024011813340278183_j_auto-2022-0146_ref_015","doi-asserted-by":"crossref","unstructured":"Z. Li, P. Avgeriou, and P. Liang, \u201cA systematic mapping study on technical debt and its management,\u201d J. Syst. Softw., vol.\u00a0101, pp.\u00a0193\u2013220, 2015. https:\/\/doi.org\/10.1016\/j.jss.2014.12.027.","DOI":"10.1016\/j.jss.2014.12.027"},{"key":"2024011813340278183_j_auto-2022-0146_ref_016","unstructured":"P. Avgeriou, P. Kruchten, I. Ozkaya, and C. Seaman, \u201cManaging technical debt in software engineering (dagstuhl seminar 16162),\u201d Dagstuhl Rep., vol.\u00a06, no.\u00a04, pp.\u00a0110\u2013138, 2016."},{"key":"2024011813340278183_j_auto-2022-0146_ref_017","doi-asserted-by":"crossref","unstructured":"T. Detofeno, A. Malucelli, and S. Reinehr, \u201cPriorTD: a method for prioritization technical debt,\u201d in Proceedings of the XXXVI Brazilian Symposium on Software Engineering, 2022, pp.\u00a0230\u2013240.","DOI":"10.1145\/3555228.3555238"},{"key":"2024011813340278183_j_auto-2022-0146_ref_018","doi-asserted-by":"crossref","unstructured":"A. Martini, J. Bosch, and M. Chaudron, \u201cInvestigating Architectural Technical Debt accumulation and refactoring over time: a multiple-case study,\u201d Inf. Softw. Technol., vol.\u00a067, pp.\u00a0237\u2013253, 2015. https:\/\/doi.org\/10.1016\/j.infsof.2015.07.005.","DOI":"10.1016\/j.infsof.2015.07.005"},{"key":"2024011813340278183_j_auto-2022-0146_ref_019","doi-asserted-by":"crossref","unstructured":"S. Biffl, L. Kathrein, A. L\u00fcder, et al.., \u201cSoftware engineering risks from technical debt in the representation of product\/ion knowledge,\u201d in Proceedings of the 31st International Conference on Software Engineering and Knowledge Engineering, 2019, pp.\u00a0693\u2013700.","DOI":"10.18293\/SEKE2019-037"},{"key":"2024011813340278183_j_auto-2022-0146_ref_020","doi-asserted-by":"crossref","unstructured":"L. Waltersdorfer, F. Rinker, L. Kathrein, and S. Biffl, \u201cExperiences with technical debt and management strategies in production systems engineering,\u201d in Proceedings of the 3rd International Conference on Technical Debt, 2020, pp.\u00a041\u201350.","DOI":"10.1145\/3387906.3388627"},{"key":"2024011813340278183_j_auto-2022-0146_ref_021","doi-asserted-by":"crossref","unstructured":"Q. H. Dong, F. Ocker, and B. Vogel-Heuser, \u201cTechnical Debt as indicator for weaknesses in engineering of automated production systems,\u201d Prod. Eng., vol.\u00a013, nos. 3\u20134, pp.\u00a0273\u2013282, 2019. https:\/\/doi.org\/10.1007\/s11740-019-00897-0.","DOI":"10.1007\/s11740-019-00897-0"},{"key":"2024011813340278183_j_auto-2022-0146_ref_022","doi-asserted-by":"crossref","unstructured":"E. M. Neumann, B. Vogel-Heuser, J. Fischer, S. Diehm, M. Schwarz, and T. Englert, \u201cAutomation software architectures in automated production systems: an industrial case study in the packaging machine industry,\u201d Prod. Eng., vol.\u00a016, pp.\u00a0847\u2013856, 2022. https:\/\/doi.org\/10.1007\/s11740-022-01133-y.","DOI":"10.1007\/s11740-022-01133-y"},{"key":"2024011813340278183_j_auto-2022-0146_ref_023","doi-asserted-by":"crossref","unstructured":"E. M. Neumann, M. Gnadlinger, J. Fischer, L. Reimoser, S. Diehm, and M. Schwarz, \u201cMetric-based identification of target conflicts in the development of industrial automation software libraries,\u201d in 2022 IEEE International Conference on Industrial Engineering and Engineering Management, 2022. (accepted).","DOI":"10.1109\/IEEM55944.2022.9989691"},{"key":"2024011813340278183_j_auto-2022-0146_ref_024","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, J. Fischer, E.-M. Neumann, and M. Kreiner, Success Factors For the Design of Field-Level Control Code in Machine and Plant Manufacturing \u2013 an Industrial Survey, [Online], Available at: https:\/\/www.researchsquare.com\/article\/rs-168613\/latest [accessed: Oct. 26, 2022].","DOI":"10.21203\/rs.3.rs-168613\/v1"},{"key":"2024011813340278183_j_auto-2022-0146_ref_025","unstructured":"Q. H. Dong and B. Vogel-Heuser, Including Validation of Process Control Systems\u2019 Engineering into the Technical Debt Classification, Forschung im Ingenieurwesen\/Engineering Research, Berlin, Springer\u2013Verlag GmbH, 2022, (submitted)."},{"key":"2024011813340278183_j_auto-2022-0146_ref_026","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, M. Obermeier, S. Braun, K. Sommer, F. Jobst, and K. Schweizer, \u201cEvaluation of a UML-based versus an IEC 61131-3-based software engineering approach for teaching PLC programming,\u201d IEEE Trans. Educ., vol.\u00a056, no.\u00a03, pp.\u00a0329\u2013335, 2013. https:\/\/doi.org\/10.1109\/te.2012.2226035.","DOI":"10.1109\/TE.2012.2226035"},{"key":"2024011813340278183_j_auto-2022-0146_ref_027","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, M. Zimmermann, K. Stahl, et al.., \u201cCurrent challenges in the design of drives for robot-like systems,\u201d in Proceedings of 2020 IEEE International Conference on Systems, Man, and Cybernetics, 2020, pp.\u00a01923\u20131928.","DOI":"10.1109\/SMC42975.2020.9282988"},{"key":"2024011813340278183_j_auto-2022-0146_ref_028","doi-asserted-by":"crossref","unstructured":"B. Vogel-Heuser, J. Fischer, D. Hess, E. M. Neumann, and M. Wurr, \u201cBoosting extra-functional code reusability in cyber-physical production systems: the error handling case study,\u201d IEEE Trans. Emerg. Topics Comput., vol.\u00a010, no.\u00a01, pp.\u00a060\u201373, 2022. https:\/\/doi.org\/10.1109\/tetc.2022.3142816.","DOI":"10.1109\/TETC.2022.3142816"},{"key":"2024011813340278183_j_auto-2022-0146_ref_029","doi-asserted-by":"crossref","unstructured":"S. Ulewicz and B. Vogel-Heuser, \u201cIndustrially applicable system regression test prioritisation in production automation,\u201d IEEE Trans. Autom., vol.\u00a015, no.\u00a04, pp.\u00a01839\u20131851, 2018. https:\/\/doi.org\/10.1109\/tase.2018.2810280.","DOI":"10.1109\/TASE.2018.2810280"},{"key":"2024011813340278183_j_auto-2022-0146_ref_030","doi-asserted-by":"crossref","unstructured":"A. Ampatzoglou, N. Mittas, A.-A. Tsintzira, et al.., \u201cExploring the relation between technical debt principal and interest: an empirical approach,\u201d Inf. Softw. Technol., vol.\u00a0128, p.\u00a0106391, 2020. https:\/\/doi.org\/10.1016\/j.infsof.2020.106391.","DOI":"10.1016\/j.infsof.2020.106391"}],"container-title":["at - Automatisierungstechnik"],"original-title":[],"language":"en","link":[{"URL":"https:\/\/www.degruyter.com\/document\/doi\/10.1515\/auto-2022-0146\/xml","content-type":"application\/xml","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/www.degruyter.com\/document\/doi\/10.1515\/auto-2022-0146\/pdf","content-type":"unspecified","content-version":"vor","intended-application":"similarity-checking"}],"deposited":{"date-parts":[[2024,1,18]],"date-time":"2024-01-18T13:35:22Z","timestamp":1705584922000},"score":1,"resource":{"primary":{"URL":"https:\/\/www.degruyter.com\/document\/doi\/10.1515\/auto-2022-0146\/html"}},"subtitle":["A risk-based approach to indicate documentation debt"],"short-title":[],"issued":{"date-parts":[[2023,8,1]]},"references-count":30,"journal-issue":{"issue":"8","published-online":{"date-parts":[[2023,8,8]]},"published-print":{"date-parts":[[2023,8,28]]}},"alternative-id":["10.1515\/auto-2022-0146"],"URL":"https:\/\/doi.org\/10.1515\/auto-2022-0146","relation":{},"ISSN":["0178-2312","2196-677X"],"issn-type":[{"value":"0178-2312","type":"print"},{"value":"2196-677X","type":"electronic"}],"subject":[],"published":{"date-parts":[[2023,8,1]]}}}