#15 Source Code Kommentare, Git Commits Messages, Merge Commits und Branch-Visualisierungs-Kunst

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 [email protected] oder via Twitter an https://twitter.com/EngKioskUnsere aktuellen Werbepartner findest du auf https://engineeringkiosk.dev/partners LinksBest 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=vBG5pUn1OlgWhat 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-encounteredMelanie Patrick: Git - How to unfuck https://www.youtube.com/watch?v=LP4F2rmi4r4Automatische Changelog/Release PRs: https://github.com/googleapis/release-pleaseSemantic Versioning: https://semver.org/Software Repository Mining: https://en.wikipedia.org/wiki/Mining_software_repositoriesAndy 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/3ae87d2f25c0e998da2721ce332e2b80d3d53c39Sprungmarken(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 Schreiben optimiert?(00:25:43) Bit-Shifting versteht doch keiner(00:28:29) Wie komplex eigentlich die Bash-Programmierung sein(00:33:11) TODO-Kommentare im Code oder lieber ein Ticket?(00:36:56) Story-Telling im Code und Entwickler-Humor(00:40:02) Kommentare in Deutsch oder Englisch und Domänen-Vokabular(00:42:34) Wie sollten Git Commit Messages aussehen? Und warum Git Commit Messages E-Mail sein können(00:45:39) Isolierte Git Commits für bessere Git Commit Messages(00:46:44) Merge Commits(00:49:59) Strukturierte Git Commit Messages und Nutzung von Prefixes wie bugfix und feature in Git Commit Messages(00:52:13) Was ist Semantic Versioning (SemVer)?(00:56:38) Der Linux Kernel als Vorbild für gute Commit Messages(00:57:55) Wolfgangs Meinung zu Merge-Commits(00:59:38) Branch-Visualisierung in Git(01:01:30) OutroHostsWolfgang Gassler (https://twitter.com/schafele)Andy Grunwald (https://twitter.com/andygrunwald)Engineering Kiosk Podcast: Anfragen an [email protected] oder via Twitter an https://twitter.com/EngKiosk