{"componentChunkName":"component---src-templates-talk-js","path":"/talks/code-comments/","result":{"data":{"markdownRemark":{"id":"5598ac87-d601-5d88-9f82-15c0a30fd200","htmlAst":{"type":"root","children":[{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"You think your code is so clean that it doesn't need any comments?\nOr are your colleagues convinced that all comments are failures?\nThen this talk is for you!"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Let's first dispute some common arguments against commenting code:"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"Comments lie?"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"Tests are better?"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"Good names suffice?"}]},{"type":"text","value":"\n"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"We'll find fault with all of them (and more)!"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"With that out of the way we'll categorize comments and analyze their costs and benefits. This will give us the means to discuss the end: Which comments will improve a code base?"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Of course, every team has to come up with its own answer. But the vocabulary and ideas presented in this talk can help find it."}]}],"data":{"quirksMode":false}},"fields":{"path":"/talks/code-comments/"},"frontmatter":{"title":"Comment That &*☠# Code!","excerpt":"Clean code needs clean comments - here's why and what that even means.","card":null,"language":null,"slides":{"pdf":null,"url":"https://slides.codefx.org/comment-your-code/2019-09-24-accento/"},"video":"https://www.youtube.com/watch?v=a4BWbbgO67Q","speakers":[{"id":"fb696360-b4fd-53c0-8d4a-7b1d0823414f","fields":{"path":"/speakers/nicolai-parlog/"},"frontmatter":{"name":"Nicolai Parlog","slug":"nicolai-parlog","bio":"Accento organizer - break glass if speaker needed","social":{"site":null,"twitter":"nipafx"}}}]}}},"pageContext":{"slug":"code-comments"}}}