„Selbst eine Word-Doku ist besser als gar keine Doku“ – Dokumentation von Software ist oft ein leidiges Thema mit noch leidigeren Werkzeugen. Lucas und Lars schauen sich in dieser Folge mal die vorhandenen Tools und Formate zur technischen Umsetzung einer guten Softwaredokumentation an. Damit am Ende niemand mehr sagen kann: „es gibt keine Doku, weil die Tools nerven“. Leider gab es in dieser Folge Probleme mit Lucas Audiospur. Beim nächsten Mal kehren wir zur gewohnten Qualität zurück.

Dokumentation technisch umsetzen

In dieser Serie diskutieren wir interessante Themen aus Software-Entwicklung und -Architektur – immer mit dem Fokus auf Praxistauglichkeit.

Technology

Tech News

Podcasting

Gadgets

Software How-To

Alle, die schon einmal mit Large Language Models wie GPT-4 gearbeitet oder experimentiert haben, kennen es: Die generative KI produziert erstaunlich natürlichsprachliche Texte, doch oft wirken die Ergebnisse generisch und führen nicht zum gewünschten Ziel. In dieser Folge gehen Anja und Robert der Frage nach: Wie formuliert man Prompts, die zu wirklich hilfreichen Ergebnissen führen? Robert rät: "Talk to it like a human". Was bedeutet das für unsere Arbeitsweise? Wie verbessert der richtige Kontext die Ergebnisse generativer KI entscheidend? Wie trifft man den richtigen Grad zwischen aufwendigem Prompt-Engineering und schnellen "Aus-der-Hüfte-Prompts"?

AI Prompting

Wie sind Technologien und soziale Strukturen miteinander verwoben? In dieser Folge spricht Anja Kammer mit Lena Kraaz und Katharina Baur, beide P* bei INNOQ, über soziotechnische Systeme. Sie gehen dabei auf die historischen Ursprünge des Begriffs im Bergbau ein und diskutieren die Rolle von Informalität und informellen Strukturen in aktuellen Projekten, um zu zeigen, wie diese Faktoren in der Praxis wirken.

Soziotechnische Systeme

Softwarearchitekt:innen sind wie damals Wanderlehrer, meint Falk Hoppe, die ihr Wissen und ihre Einsichten von Team zu Team tragen und eine Kultur des Austauschs und des Verständnisses fördern. Doch wie prägt diese Rolle die tägliche Arbeit und den Austausch innerhalb der Teams? Worin unterscheiden sich interne und externe Architekturberatung? Und wie manifestiert sich eine spezifische Kultur der Architekturarbeit in Unternehmen? In dieser Folge des INNOQ Podcasts diskutieren Anja Kammer und Falk Hoppe diese Fragen und zeigen auf, warum Kultur und Kommunikation wichtige Bestandteile für erfolgreiche Architekturarbeit sind.

Kultur der Architekturarbeit

Eine zentrale Frage steht am Beginn dieser Folge zu Architekturqualität mit Sven Johann und Gernot Starke: Was bedeutet eigentlich Qualität? Im Gespräch erörtern sie, wie durch direkte Dialoge mit Stakeholdern Anforderungen nicht nur identifiziert, sondern auch effektiv für die Entwicklungsarbeit nutzbar gemacht werden können. Mit einer Vielzahl an praxisnahen Beispielen illustrieren die, wie essenziell es ist, Qualitätsanforderungen flexibel an den jeweiligen Projektkontext anzupassen.

Architekturqualität

Antipatterns können nicht nur auf Codeebene, sondern auch auf der Architekturebene auftreten. Sven, Andreas, Christian und Felix diskutieren in dieser Folge die Fallstricke solcher Antipatterns. Sie beleuchten, wie Dokumentation mit ADRs beim Verstehen und Anpassen von Architekturentscheidungen helfen kann und betonen die Wichtigkeit des Kontexts bei der Bewertung von Patterns und Antipatterns. Außerdem werfen sie einen Blick auf die Microsite architecture-antipatterns.tech und laden Euch ein, die Sammlung mit eigenen Case Studies zu erweitern.

Dokumentation technisch umsetzen

Download our free app to listen on your phone