Artwork

Inhalt bereitgestellt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll. Alle Podcast-Inhalte, einschließlich Episoden, Grafiken und Podcast-Beschreibungen, werden direkt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll oder seinem Podcast-Plattformpartner hochgeladen und bereitgestellt. Wenn Sie glauben, dass jemand Ihr urheberrechtlich geschütztes Werk ohne Ihre Erlaubnis nutzt, können Sie dem hier beschriebenen Verfahren folgen https://de.player.fm/legal.
Player FM - Podcast-App
Gehen Sie mit der App Player FM offline!

094 | Zwischen IDE und Markdown: Dokumentation, die Developer glücklich macht

1:09:59
 
Teilen
 

Manage episode 461871745 series 3432291
Inhalt bereitgestellt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll. Alle Podcast-Inhalte, einschließlich Episoden, Grafiken und Podcast-Beschreibungen, werden direkt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll oder seinem Podcast-Plattformpartner hochgeladen und bereitgestellt. Wenn Sie glauben, dass jemand Ihr urheberrechtlich geschütztes Werk ohne Ihre Erlaubnis nutzt, können Sie dem hier beschriebenen Verfahren folgen https://de.player.fm/legal.

Warum scheitert Dokumentation so oft daran, wirklich hilfreich zu sein? Was sollte dokumentiert werden, warum ist das überhaupt nötig und wie macht man es richtig? Es geht um die großen und kleinen Hürden im Alltag – von ADRs über Readmes bis zu Dokumentations-Tools und dem ewigen Konflikt zwischen IDE-Nähe und veralteten Prozessen.

Wir sprechen über Onboarding, Tests als Doku und ob wir Doku selbst nicht auch wie Code behandeln können.

Zusätzlich werfen wir einen Blick auf Workflows abseits von Best Practices, die Rolle von geschlossenen Systemen mit Interfaces und die Verantwortung, die bei jedem Teammitglied liegt, damit Dokumentation aktuell bleibt. Mit einem pragmatischen Fokus gehen wir der Frage nach, wie wir aus der Theorie endlich Praxis machen können – ohne dass die Infos im Slack-Chaos oder in längst vergessenen Markdown-Files verschwinden.

Community:

💜 Werde Teil der IOOB Discord Community: https://discord.gg/bbC5c4vvQY

Links:

https://stackoverflow.blog/2024/11/26/your-docs-are-your-infrastructure/

Kontakt:

👉 http://ioob.de
📬 [email protected]
𝕏 http://x.com/IoobPodcast
📺 http://youtube.com/@ioobpodcast

  continue reading

112 Episoden

Artwork
iconTeilen
 
Manage episode 461871745 series 3432291
Inhalt bereitgestellt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll. Alle Podcast-Inhalte, einschließlich Episoden, Grafiken und Podcast-Beschreibungen, werden direkt von Christian Braun und Thomas Diroll, Christian Braun, and Thomas Diroll oder seinem Podcast-Plattformpartner hochgeladen und bereitgestellt. Wenn Sie glauben, dass jemand Ihr urheberrechtlich geschütztes Werk ohne Ihre Erlaubnis nutzt, können Sie dem hier beschriebenen Verfahren folgen https://de.player.fm/legal.

Warum scheitert Dokumentation so oft daran, wirklich hilfreich zu sein? Was sollte dokumentiert werden, warum ist das überhaupt nötig und wie macht man es richtig? Es geht um die großen und kleinen Hürden im Alltag – von ADRs über Readmes bis zu Dokumentations-Tools und dem ewigen Konflikt zwischen IDE-Nähe und veralteten Prozessen.

Wir sprechen über Onboarding, Tests als Doku und ob wir Doku selbst nicht auch wie Code behandeln können.

Zusätzlich werfen wir einen Blick auf Workflows abseits von Best Practices, die Rolle von geschlossenen Systemen mit Interfaces und die Verantwortung, die bei jedem Teammitglied liegt, damit Dokumentation aktuell bleibt. Mit einem pragmatischen Fokus gehen wir der Frage nach, wie wir aus der Theorie endlich Praxis machen können – ohne dass die Infos im Slack-Chaos oder in längst vergessenen Markdown-Files verschwinden.

Community:

💜 Werde Teil der IOOB Discord Community: https://discord.gg/bbC5c4vvQY

Links:

https://stackoverflow.blog/2024/11/26/your-docs-are-your-infrastructure/

Kontakt:

👉 http://ioob.de
📬 [email protected]
𝕏 http://x.com/IoobPodcast
📺 http://youtube.com/@ioobpodcast

  continue reading

112 Episoden

Alle Folgen

×
 
Loading …

Willkommen auf Player FM!

Player FM scannt gerade das Web nach Podcasts mit hoher Qualität, die du genießen kannst. Es ist die beste Podcast-App und funktioniert auf Android, iPhone und im Web. Melde dich an, um Abos geräteübergreifend zu synchronisieren.

 

Kurzanleitung

Hören Sie sich diese Show an, während Sie die Gegend erkunden
Abspielen