Artwork

Inhoud geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung. Alle podcastinhoud, inclusief afleveringen, afbeeldingen en podcastbeschrijvingen, wordt rechtstreeks geüpload en geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung of hun podcastplatformpartner. Als u denkt dat iemand uw auteursrechtelijk beschermde werk zonder uw toestemming gebruikt, kunt u het hier beschreven proces https://nl.player.fm/legal volgen.
Player FM - Podcast-app
Ga offline met de app Player FM !

Best Practices für (Architektur)dokumentation - Falk Sippach

21:59
 
Delen
 

Manage episode 440334256 series 3466870
Inhoud geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung. Alle podcastinhoud, inclusief afleveringen, afbeeldingen en podcastbeschrijvingen, wordt rechtstreeks geüpload en geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung of hun podcastplatformpartner. Als u denkt dat iemand uw auteursrechtelijk beschermde werk zonder uw toestemming gebruikt, kunt u het hier beschreven proces https://nl.player.fm/legal volgen.
Dokumentation als Code

Tipp: Software Test Mastermind Dein Inner Circle für Sparring, mehr Erfolg und Wachstum als Tester, Testmanager oder Testautomatisierer https://swt.fm/mastermind

“Documentation as Code ist die Idee, dass wir die Dokumentation wie Source Code behandeln, also die selben Werkzeuge nutzen können und das Ganze auch in Build-Prozesse integrieren, automatisieren können.” - Falk Sippach

In dieser Folge sprechen wir über die Bedeutung und Methoden einer effizienten Architekturdokumentation. Dabei thematisieren wir, wie Dokumentation oft vernachlässigt wird und welche Lösungen es gibt, um dies zu vermeiden. Die Ansätze 'Documentation as Code' und 'Continuous Documentation' ermöglichen es, Dokumentation wie Quellcode zu behandeln und kontinuierlich zu aktualisieren. Zudem befassen wir uns mit der Nutzung von Tools wie Markdown und ASCII-Doc, die den Prozess der Erstellung und Pflege von Dokumentationen erleichtern. Anhand zahlreicher praktischer Beispiele und Tipps wird verdeutlicht, wie Entwickler und Tester ihre Dokumentation leichtgewichtig und effektiv gestalten können.

Falk Sippach ist als Softwarearchitekt, Berater und Trainer stets auf der Suche nach dem Funken Leidenschaft, den er bei seinen Teilnehmern, Kunden und Kollegen entfachen kann. Bereits seit 20 Jahren unterstützt er in meist agilen Softwareentwicklungsprojekten im Java-Umfeld. Als aktiver Bestandteil der Community (Mitorganisator der JUG Darmstadt und Mitglied der Java Champions) teilt er zudem sein Wissen gern in Artikeln, Blog-Beiträgen, sowie bei Vorträgen auf Konferenzen oder User Group Treffen und unterstützt bei der Organisation diverser Fachveranstaltungen.

Highlights:

  • Dokumentation ist für Tester wichtig als Testbasis und Nachschlagewerk.
  • Falk erklärt, wie Dokumentation oft vernachlässigt wird und warum das so ist.
  • Documentation as Code bedeutet, Dokumentation wie Source Code zu behandeln und in Textformaten wie Markdown oder ASCII-Doc zu schreiben.
  • Continuous Documentation integriert die Dokumentation in den gesamten Entwicklungsprozess, ähnlich wie Continuous Integration und Continuous Delivery.
  • Integration von Bildern und Diagrammen in die Dokumentation

Danke an die Community-Partner des Podcasts:Alliance for Qualification | ASQF | Austrian Testing Board | dpunkt.verlag | German Testing Board | German Testing Day | GI Fachgruppe TAV | Heise | HANSER Verlag | ISTQB | iSQI GmbH | oop | QS-TAG | SIGS-DATACOM | skillsclub | Swiss Testing Board | TACON

Credits: Sound | Grafik

  continue reading

Hoofdstukken

1. Einführung und Bedeutung der Architekturdokumentation (00:00:00)

2. Herausforderungen bei der Dokumentation (00:02:28)

3. Ansätze zur Verbesserung der Dokumentation (00:05:50)

4. Einführung in die Architekturdokumentation (00:11:09)

5. Vorteile von DrawIO und Diagramms as Code (00:12:09)

6. Continuous Documentation und Automatisierung (00:15:00)

131 afleveringen

Artwork
iconDelen
 
Manage episode 440334256 series 3466870
Inhoud geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung. Alle podcastinhoud, inclusief afleveringen, afbeeldingen en podcastbeschrijvingen, wordt rechtstreeks geüpload en geleverd door Richard Seidl - Experte für Software-Entwicklung und Testautomatisierung and Richard Seidl - Experte für Software-Entwicklung of hun podcastplatformpartner. Als u denkt dat iemand uw auteursrechtelijk beschermde werk zonder uw toestemming gebruikt, kunt u het hier beschreven proces https://nl.player.fm/legal volgen.
Dokumentation als Code

Tipp: Software Test Mastermind Dein Inner Circle für Sparring, mehr Erfolg und Wachstum als Tester, Testmanager oder Testautomatisierer https://swt.fm/mastermind

“Documentation as Code ist die Idee, dass wir die Dokumentation wie Source Code behandeln, also die selben Werkzeuge nutzen können und das Ganze auch in Build-Prozesse integrieren, automatisieren können.” - Falk Sippach

In dieser Folge sprechen wir über die Bedeutung und Methoden einer effizienten Architekturdokumentation. Dabei thematisieren wir, wie Dokumentation oft vernachlässigt wird und welche Lösungen es gibt, um dies zu vermeiden. Die Ansätze 'Documentation as Code' und 'Continuous Documentation' ermöglichen es, Dokumentation wie Quellcode zu behandeln und kontinuierlich zu aktualisieren. Zudem befassen wir uns mit der Nutzung von Tools wie Markdown und ASCII-Doc, die den Prozess der Erstellung und Pflege von Dokumentationen erleichtern. Anhand zahlreicher praktischer Beispiele und Tipps wird verdeutlicht, wie Entwickler und Tester ihre Dokumentation leichtgewichtig und effektiv gestalten können.

Falk Sippach ist als Softwarearchitekt, Berater und Trainer stets auf der Suche nach dem Funken Leidenschaft, den er bei seinen Teilnehmern, Kunden und Kollegen entfachen kann. Bereits seit 20 Jahren unterstützt er in meist agilen Softwareentwicklungsprojekten im Java-Umfeld. Als aktiver Bestandteil der Community (Mitorganisator der JUG Darmstadt und Mitglied der Java Champions) teilt er zudem sein Wissen gern in Artikeln, Blog-Beiträgen, sowie bei Vorträgen auf Konferenzen oder User Group Treffen und unterstützt bei der Organisation diverser Fachveranstaltungen.

Highlights:

  • Dokumentation ist für Tester wichtig als Testbasis und Nachschlagewerk.
  • Falk erklärt, wie Dokumentation oft vernachlässigt wird und warum das so ist.
  • Documentation as Code bedeutet, Dokumentation wie Source Code zu behandeln und in Textformaten wie Markdown oder ASCII-Doc zu schreiben.
  • Continuous Documentation integriert die Dokumentation in den gesamten Entwicklungsprozess, ähnlich wie Continuous Integration und Continuous Delivery.
  • Integration von Bildern und Diagrammen in die Dokumentation

Danke an die Community-Partner des Podcasts:Alliance for Qualification | ASQF | Austrian Testing Board | dpunkt.verlag | German Testing Board | German Testing Day | GI Fachgruppe TAV | Heise | HANSER Verlag | ISTQB | iSQI GmbH | oop | QS-TAG | SIGS-DATACOM | skillsclub | Swiss Testing Board | TACON

Credits: Sound | Grafik

  continue reading

Hoofdstukken

1. Einführung und Bedeutung der Architekturdokumentation (00:00:00)

2. Herausforderungen bei der Dokumentation (00:02:28)

3. Ansätze zur Verbesserung der Dokumentation (00:05:50)

4. Einführung in die Architekturdokumentation (00:11:09)

5. Vorteile von DrawIO und Diagramms as Code (00:12:09)

6. Continuous Documentation und Automatisierung (00:15:00)

131 afleveringen

Alle afleveringen

×
 
Loading …

Welkom op Player FM!

Player FM scant het web op podcasts van hoge kwaliteit waarvan u nu kunt genieten. Het is de beste podcast-app en werkt op Android, iPhone en internet. Aanmelden om abonnementen op verschillende apparaten te synchroniseren.

 

Korte handleiding

Luister naar deze show terwijl je op verkenning gaat
Spelen