The Art of Code Comments - Sarah Drasner | JSConf Hawaii 2020
Commenting code is a more nuanced thing than we give it credit for.
There are a couple of schools of thought on this. One states that if you feel a comment is necessary, you should rewrite it to be more legible. This is true. But it's also not true. In the process of writing a comment, you can often find things that could be written better, but it's not an either/or, for the following reason: Code can describe how, but it cannot explain why.
There is just not one right way or one reason to write a comment.In this session, we'll dig into some of the many beneficial types of comments that might all serve a different purpose, followed by patterns we might want to avoid. In the process we'll talk about being good teammates, collaborating, and writing the most legible code we can.
JSConf Hawaii will return soon
https://www.jsconfhi.com/
Видео The Art of Code Comments - Sarah Drasner | JSConf Hawaii 2020 канала JSConf
There are a couple of schools of thought on this. One states that if you feel a comment is necessary, you should rewrite it to be more legible. This is true. But it's also not true. In the process of writing a comment, you can often find things that could be written better, but it's not an either/or, for the following reason: Code can describe how, but it cannot explain why.
There is just not one right way or one reason to write a comment.In this session, we'll dig into some of the many beneficial types of comments that might all serve a different purpose, followed by patterns we might want to avoid. In the process we'll talk about being good teammates, collaborating, and writing the most legible code we can.
JSConf Hawaii will return soon
https://www.jsconfhi.com/
Видео The Art of Code Comments - Sarah Drasner | JSConf Hawaii 2020 канала JSConf
Показать
Комментарии отсутствуют
Информация о видео
Другие видео канала
The Art of Code - Dylan BeattieSVG Will Save Us, Sarah Drasner @ #PerfMatters Conference 2019HTTP headers for the responsible developer by Stefan Judis | JSConf EU 2019Custom Hooks in React: The Ultimate UI Abstraction Layer - Tanner Linsley | JSConf Hawaii 2020Funny Source Code CommentsIs it Bad to Comment Code? Easy Self-Documenting PracticesApollo 10 Source Code Listing: The Art of CommentingBEHIND THE CODE: The one who writes articles as she learnsJavaScript Engines: The Good Parts™ - Mathias Bynens & Benedikt Meurer - JSConf EU 2018SVG can do that?! (Sarah Drasner)Comparing C to machine languageWhat Tamagotchis Can Teach You About ES6 Generators - Jenn Creighton | JSConf Hawaii 2019C Programming Tutorial 16 - CommentsAre Code Comments Important? Are Comments Bad? Is Code Self-Documenting?How This Guy Uses A.I. to Create Art | Obsessed | WIREDEvan You on Vue.js: Seeking the Balance in Framework Design | JSConf.Asia 201910 Mayan Secret Places That Were Hidden for CenturiesThe Art of Clean Code by Victor RenteaThe Most Annoying Website - Feross Aboukhadijeh - JSConf US 2018