One of the most vocal opposition of code comments is that, code comments become outdated and thus harmful. Code comments are a great way to store very specific information of functions, hacks and decisions that gets lost over time.
We often talk about documentation in two forms: either code comments that live with the code or readmes, API docs and other more curated written documentation. But both of them suffer from lack of history. But there’s more!
We often look back at decisions without having the understanding and knowledge of that moment and critize the code or decisions made hastily. But almost always, decisions are made using the best understanding and knowledge (and restrictions of reality) of that particular moment in time.
In this talk, Juha-Matti Santala explores how you can issue tracker tickets, git commits and pull requests as a contemporary documentation: something that tells us about the world as it was when decisions were made and that doesn’t change as the project moves on.
Presenter - Juha-Matti Santala
Learn from your mistakes
Learn from your mistakes (Audio Only)
Have you tried Deno yet?
Have you tried Deno yet? (Audio Only)
You Make My Head Spin: Reducing Motion on the Web
You Make My Head Spin: Reducing Motion on the Web (Audio Only)
React Error Boundary ft. TDD with Testing Library
React Error Boundary ft. TDD with Testing Library (Audio Only)
Adversarial Stylesheets: User-styles for better Accessibility
Adversarial Stylesheets: User-styles for better Accessibility (Audio Only)
Observable Notebooks - Rapid Development and Dissemination
Observable Notebooks - Rapid Development and Dissemination (Audio Only)
A foray into the world of Progressive Web Apps
A foray into the world of Progressive Web Apps (Audio Only)
Learning in public
Learning in public (Audio Only)
PL Theory 1: How to categorize programming languages along multiple axes
PL Theory 1: How to categorize programming languages along multiple axes (Audio Only)
Beer Today Beer Tomorrow
A Prairie Home Companion: News from Lake Wobegon
Agatha Christie BBC
Morning Edition : NPR
Copyright © 2006-2021 Podbean.com