Episode Details
Back to Episodes
#15 Source Code Kommentare, Git Commits Messages, Merge Commits und Branch-Visualisierungs-Kunst
Description
Kommentare im Quellcode und Git Commit Messages - Liest die überhaupt wer?
Ein Streit, der so alt ist wie die Software Entwicklung selbst: Code ist Selbsterklärend und braucht keine Kommentare. Oder doch? Und die Git Historie ist auch eigentlich sinnlos. Warum sollte da jemand zurück gehen und sich die Commit Messages durchlesen?
Diese Fragen und Themen wie Semantic Versioning, Idiomatische Programmier-Patterns, Merge Commits, Story-Tellung und was Fynn Kliemanns Kunst mit der Git Branch-Visualisierung zu tun hat, klären Wolfgang und Andy in dieser Episode vom Engineering Kiosk.
Bonus: Warum Andy einen neuen Podcast-Partner sucht und Wolfgang lieber seinen Code angreift, anstatt Ihn zu entwickeln.
Feedback an stehtisch@engineeringkiosk.dev oder via Twitter an https://twitter.com/EngKiosk
Unsere aktuellen Werbepartner findest du auf https://engineeringkiosk.dev/partners
Links
- Best practices for writing code comments: https://stackoverflow.blog/2021/12/23/best-practices-for-writing-code-comments/
- SymfonyLive Cologne 2016 - Jan van Thoor - Open Heart Surgery In Production: https://www.youtube.com/watch?v=vBG5pUn1Olg
- What is the best comment in source code you have ever encountered?: https://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered
- Melanie Patrick: Git - How to unfuck https://www.youtube.com/watch?v=LP4F2rmi4r4
- Automatische Changelog/Release PRs: https://github.com/googleapis/release-please
- Semantic Versioning: https://semver.org/
- Software Repository Mining: https://en.wikipedia.org/wiki/Mining_software_repositories
- Andy Grunwald - The story of my bachelor thesis about Software Repository Mining: https://andygrunwald.com/blog/the-story-of-my-bachelor-thesis-about-software-repository-mining/
- Linux Kernel Git Commit Messages Beispiel: https://github.com/torvalds/linux/commit/3ae87d2f25c0e998da2721ce332e2b80d3d53c39
Sprungmarken
(00:00:00) Intro
(00:01:21) Home Office: Job und Privat stark trennen?
(00:02:31) Warum macht man Sport und wie steht Wolfgang zur bayerischen Ess- und Feierkultur
(00:03:43) Karriere oder Software-Engineering Podcast und Hardcore-Tech-Thema
(00:04:38) Wie viel Kommentare hat die letzte Datei, die du in der IDE offen hattest?
(00:01:16) Wie stehst du allgemein zu Kommentaren?
(00:01:05) Was sind sinnvolle Kommentare und ist Code wirklich selbsterklärend?
(00:13:55) Komplexen code refactoren oder lieber gut kommentieren?
(00:17:40) Kommentare für kopierten Stack Overflow Code
(00:19:48) Kommentare für die Business-Domäne
(00:20:11) Algorithmen und Variablen mit einem Buchstaben
(00:21:46) Können gute Variablen und Funktionsnamen Kommentare ersetzen?
(00:23:43) Wird der Code fürs Lesen oder Schr