使用Player FM应用程序离线!
094 | Zwischen IDE und Markdown: Dokumentation, die Developer glücklich macht
Manage episode 461871745 series 3432291
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
📬 input@ioob.de
𝕏 http://x.com/IoobPodcast
📺 http://youtube.com/@ioobpodcast
94集单集
Manage episode 461871745 series 3432291
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
📬 input@ioob.de
𝕏 http://x.com/IoobPodcast
📺 http://youtube.com/@ioobpodcast
94集单集
كل الحلقات
×欢迎使用Player FM
Player FM正在网上搜索高质量的播客,以便您现在享受。它是最好的播客应用程序,适用于安卓、iPhone和网络。注册以跨设备同步订阅。