Logo des Repositoriums

Auflistung nach Schlagwort "Documentation"

1 - 4 von 4
  • Zeitschriftenartikel
    Agile Dokumentation: Anspruch und Wirklichkeit – eine fallstudienbezogene Analyse mehrerer Softwareentwicklungsprojekte
    (HMD Praxis der Wirtschaftsinformatik: Vol. 57, No. 1, 2020) Mathews, Laura; Holzweißig, Kai
    Die agile Softwareentwicklung gewinnt in der heutigen Unternehmenspraxis zunehmend an Bedeutung und löst an vielen Stellen klassische Vorgehensmodelle ab. Dies wirft aus wissenschaftlicher Sicht die Frage auf, welche Konsequenzen für etablierte Praktiken, wie beispielsweise die Softwaredokumentation, damit verbunden sind. Während die Dokumentation in der klassischen Softwareentwicklung einen hervorgehobenen Stellenwert besitzt, wird ihr Wert im Rahmen agiler Praktiken hingegen relativiert. Da weder im Agilen Manifest noch in den agilen Methoden konkrete Vorgaben hinsichtlich der Dokumentation existieren, stellt die Gestaltung dieser eine große Herausforderung für agile Projekte dar. Im Rahmen des vorliegenden Artikels wird daher eine kritische Betrachtung des Themas vorgenommen. Hierzu wird der aktuelle Stand der Forschung erhoben sowie eine fallstudienbezogene Analyse mehrerer Softwareentwicklungsprojekte bei einem weltweit tätigen Unternehmen der Softwareentwicklungsbranche durchgeführt. Die Ergebnisse zeigen, dass weder in Theorie noch Praxis verbindliche oder einheitliche Standards bezüglich der empfohlenen Dokumentationsartefakte sowie eines Dokumentationsvorgehens existieren. Dennoch werden durch die betrachteten Fallbeispiele verschiedene Realisierungsmöglichkeiten einer Softwaredokumentation im agilen Umfeld aufgezeigt. Ferner werden mögliche Gründe für die Heterogenität agiler Dokumentationspraktiken diskutiert, um Anhaltspunkte für weiteren Forschungsbedarf zu geben. Agile software development is becoming more and more relevant in today’s business practices and supersedes classical approaches in many places. From a scientific point of view, this change entails many consequences for established practices, such as for software documentation. While documentation is ascribed high importance in classical software development, its role is often subordinate in agile practices. As neither in the Agile Manifesto nor in the different agile methods any concrete guidelines regarding documentation are given, the criteria of good documentation are unclear for agile projects. This situation provides the motivation for the present article, which conducts a critical analysis of agile documentation. The current state of research is discussed and a case study of multiple software development projects is conducted at a global player in the software development industry. The results show that neither in theory nor in practice binding or uniform standards regarding recommended documentation artefacts and documentation approaches exist. However, the different case samples studied offer deeper insights into different options of software documentation in the agile context. Furthermore, potential reasons for the heterogeneity of agile documentation practices are discussed in order to provide indications for further research.
  • Konferenzbeitrag
    Detecting Inconsistencies in Software Architecture Documentation Using Traceability Link Recovery
    (Software Engineering 2024 (SE 2024), 2024) Keim, Jan; Corallo, Sophie; Fuchß, Dominik; Koziolek, Anne
  • Zeitschriftenartikel
    „Ich weiß was ihr letzte Sitzung getan habt“ – Entwicklung und Anwendung eines Softwarewerkzeuges zur Dokumentation von Design Thinking-Projekten
    (HMD Praxis der Wirtschaftsinformatik: Vol. 56, No. 1, 2019) Hofer, Julien; Schoormann, Thorsten; Kortum, Jonas; Knackstedt, Ralf
    Kreativität ist zu einem fundamentalen Faktor für Unternehmen und Organisationen geworden, um bspw. neuartige Produkte und Dienstleistungen oder innovative Geschäftsmodelle zu entwickeln, die das Sicherstellen der langfristigen Wettbewerbsfähigkeit ermöglichen. Zur Förderung von Kreativität kann auf kollaborative und iterative Vorgehensmodelle wie das weit verbreitete Design Thinking zurückgegriffen werden. Während sich eine Vielzahl von (Praxis‑)Ansätzen und Literatur mit Richtlinien für den Ablauf und für die Auswahl geeigneter Methoden befasst, sind nur wenige Ansätze für die Dokumentation solcher Projekte verfügbar. Obwohl eine Dokumentation verschiedene Aspekte wie die Standardisierung eines Projektes, die Reflektion bestehender Resultate und die Kommunikation von Design-Entscheidungen unterstützt, konnte in Projekten beobachtet werden, dass das kontinuierliche Dokumentieren der iterativen Lösungswege, die interdisziplinären Teams vor große Herausforderungen stellt. Der vorliegende Beitrag untersucht daher Potenziale von IT-basierten Werkzeugen für die Unterstützung der gemeinschaftlichen Dokumentation von Design Thinking-Projekten. Dafür werden zunächst Anforderungen auf der Basis von Literatur, Interviews und Projektdokumentationen abgeleitet sowie anschließend prototypisch in einem Softwareartefakt implementiert und demonstriert. Insgesamt können die Erkenntnisse bspw. zur Weiterentwicklung von bestehenden Werkzeugen zur Dokumentation von kreativen und kollaborativen Prozessen verwendet werden oder Impulse für Dokumentationswerkzeuge (auch) aus anderen Bereichen wie der Softwareentwicklung liefern. Zudem kann die prototypische Implementierung bereits zur Unterstützung von Design Thinking-Projekten genutzt werden. Creativity has become a fundamental issue for companies and organizations in order to design novel products and services or innovative business models, which aim to ensure sustainable competitive advantages. To promote creativity, collaborative and iterative procedure models such as the widely-applied Design Thinking can be used. While a numerous of (practical) approaches, research and academic literature deals with guidelines for the process and for a suitable selection of methods, only limited approaches focus on the documentation of such projects. Although documentation contributes to different aspects such as the standardization of a project, the reflection of existing results and the communication of design decisions, it has been observed in various projects that the continuous documentation of iterative solutions poses challenges for the interdisciplinary teams. Therefore, this article explores potential of IT-based tools that support collaborative documentation of design thinking projects. To do so, requirements based on literature, interviews and existing project documentations are derived, and then prototypically implemented and demonstrated in form of a software artifact. Overall, the findings can be used, for example, for the further development of existing tools that support the documentation of creative and collaborative processes or provide impulses for documentation tools from other areas such as software development. Moreover, the software prototype can already be used to support design thinking projects.
  • Textdokument
    Process documentation as estimate for effective IT Governance
    (INFORMATIK 2017, 2017) von der Heyde, Markus; Andreas, Breiter
    In organizations the overall work is split into tasks which are often referred to as processes. It is debatable if the tasks and procedures need to be documented or not. Does documenting processes of information technology (IT) make a difference for the organization? We have evidence that in higher education organizations in Germany, many institutions suffered in the past from the lack of documentation of IT. In this paper, we will present data that confirms advantages beyond the scope of the IT itself for organizations such as those universities who care for the documentation of the processes. The 2016 data from a survey in the German higher education system is analyzed specifically when looking at the question of pure existence of documentation of IT processes. How is this trivial view interlinked with other factors of the CIO structure, the IT financial situation, and many more? We observed that universities with IT process documentation on average a) spend more money on staff, b) get more value from IT, c) care for service level agreements, d) have higher security awareness, and e) have less shadow IT and being more centralized. Our findings are in line with proposition of BPMM, COBIT, ITIL and other frameworks, thus we support the emphasis on process orientation of IT including a solid documentation.