{"id":4803,"date":"2017-02-16T16:26:19","date_gmt":"2017-02-16T16:26:19","guid":{"rendered":"https:\/\/blog-stg.cheesecakelabs.com\/blog\/code-review-easier-better-faster-stronger\/"},"modified":"2022-07-01T17:44:13","modified_gmt":"2022-07-01T17:44:13","slug":"code-review-easier-better-faster-stronger","status":"publish","type":"post","link":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/","title":{"rendered":"Code Review: Easier Better Faster Stronger"},"content":{"rendered":"

Yes, you read it right. I took the liberty to adapt <\/span>Daft Punk’s song title<\/span><\/a> to talk about <\/span>code review<\/b>. As I write this, I’m wondering  if it is going to pass the thorough examination of the chief editor, but I like how the title sounds (and it really describes how a Pull Request should be). And you see, even this harmless piece of text is going over a <\/strong><\/span>rvesoin<\/strong><\/del> revision process<\/strong> before you can have the chance to be struck by my insights, so why shouldn’t we do the same with our code<\/strong>?<\/span><\/p>\n

<\/p>\n

Code review is the process of having a peer developer reading your code after it’s done or during development time (pair-programming)<\/span>. The main goals are to find overlooked mistakes<\/strong>, guarantee the maintenance of the code style guidelines<\/strong> and discover more elegant ways to solve<\/strong> the same problem, taking into account scalability and performance, for instance. The result is software with better quality<\/strong> and wider involvement<\/strong> of the development team. Having your code inspected by someone else has many positive impacts:<\/p>\n

    \n
  1. Find errors<\/strong>, possible vulnerabilities and under-performing code before it reaches the final user (or even before it reaches QA, depending on your process).
    \n<\/span><\/li>\n
  2. Spread knowledge<\/strong> among all participants, making sure there are at least two people that know what’s going on with that chunk of code.
    \n<\/span><\/li>\n
  3. Encourage constructive discussion<\/strong> with other developers: when people dive deeper into the code as a group, they tend to write better code as a group.<\/span><\/li>\n
  4. Distribute responsibility and ownership<\/strong>. This way, nobody has to feel the pressure of failure on their own and everybody takes credit when it succeeds.<\/span><\/li>\n
  5. It’s an excellent way for junior developers to learn<\/strong> with more seasoned professionals.<\/span><\/li>\n<\/ol>\n

    Despite all these advantages, a lot of developers still shiver when they are assigned to a Pull Request. Code review is many times taken as unnecessary, inefficient and deadly boring<\/strong>. Don’t get me wrong: I understand this is sometimes the case. What I want to point out is that the problem usually isn’t the code review itself<\/strong>, but the process involved. Picture the following scenario:<\/span><\/p>\n

    You see a new Pull Request assigned to you. At first, you have no idea what’s it all about. The title reads: “Improvements and refactor”. You click on the link and see an ocean of green and red marks: four thousand additions, a thousand deletions. You don’t freak out, start full gas: “comment it, scroll it, improve it, code it” (read with robotic voice)<\/em>. Soon you are bored, comments are less and less frequent, and the code review loses its purpose.<\/span><\/p>\n

     <\/p>\n

    \"\"<\/p>\n

     <\/p>\n

    This is not because the revision process doesn’t work at all, it’s simply because it’s being done the wrong way<\/strong>. Here are some principles we try to follow at our best here at Cheesecake Labs to improve code review quality<\/strong>:<\/span>
    \n<\/span><\/p>\n

      \n
    1. Keep your PR focused on its goal:<\/strong> if you just want to fix a typo, that’s all you’re going to do. Don’t take the chance to do small refactorings here and there, they are a big source of distraction for those reviewing your code.<\/span><\/li>\n
    2. Write meaningful commit messages and PR titles:<\/strong> give people some context on what are you trying to achieve with your code.<\/span><\/li>\n
    3. Try your best to keep it under 500 lines<\/strong> between additions and deletions: less lines of code means less time reviewing it (and a more concentrated reviewer as a result).<\/span><\/li>\n
    4. Use linting and automated tests:<\/strong> the reviewer shouldn\u2019t waste time with what the computer could have done.<\/span><\/li>\n
    5. Keep related code as close as possible:<\/strong> if two files have related code \u2013 let’s say the view and the controller \u2013 save them close to each other, in the same directory if possible. This way they are going to appear one right after the other on the code diff.<\/span><\/li>\n
    6. Keep the trailing comma in multiline literals<\/strong> (arrays, objects, dictionaries): it may sound small, but it can save a considerable amount of time with <\/span>merge conflicts<\/a>. As a plus, it appears as a one-line change on versioning diff, instead of two.<\/span><\/li>\n
    7. Follow a code style pattern:<\/strong> our brain is trained to understand patterns. If you always structure imports, docstrings, breaks and naming the same way, your code will be less tiring and easier to read.<\/span><\/li>\n
    8. Last but not least: don’t take things personally<\/strong>. Unless someone is really rude with comments, everything is annotated to improve the product’s overall quality. You can still be friends and have a beer together later.<\/span><\/li>\n<\/ol>\n

      Here at Cheesecake Labs we take code review as a core part of our culture<\/strong>. We use it to have awesome conversations<\/strong> among devs, learn new technologies<\/strong> with more experienced peers, let others know<\/strong> how we solve problems and most importantly: deliver great software as a team<\/strong>.<\/span><\/p>\n

      By the way, want to learn Pull Request submission best practices? Check out this post that my friend Iacami wrote about it: Git Etiquette: Submitting a Pull Request<\/a>.<\/p>\n

      Cover Image: Adapted from “Daft Punk by Shaun Laakso”. Creative Commons Attribution-NonCommercial 4.0<\/a><\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

      Yes, you read it right. I took the liberty to adapt Daft Punk’s song title to talk about code review. As I write this, I’m wondering  if it is going to pass the thorough examination of the chief editor, but I like how the title sounds (and it really describes how a Pull Request should […]<\/p>\n","protected":false},"author":65,"featured_media":9025,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[471,344],"tags":[1153],"class_list":["post-4803","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-engenharia","category-opiniao","tag-tag-code-br"],"yoast_head":"\nCode Review: Easier Better Faster Stronger | Cheesecake Labs<\/title>\n<meta name=\"description\" content=\"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.\" \/>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Code Review: Easier Better Faster Stronger | Cheesecake Labs\" \/>\n<meta property=\"og:description\" content=\"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/\" \/>\n<meta property=\"og:site_name\" content=\"Cheesecake Labs\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/cheesecakelabs\" \/>\n<meta property=\"article:published_time\" content=\"2017-02-16T16:26:19+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-07-01T17:44:13+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2017\/02\/Banner_betterforeview.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2000\" \/>\n\t<meta property=\"og:image:height\" content=\"720\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Cheesecake Labs\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@cheesecakelabs\" \/>\n<meta name=\"twitter:site\" content=\"@cheesecakelabs\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. tempo de leitura\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/\",\"url\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/\",\"name\":\"Code Review: Easier Better Faster Stronger | Cheesecake Labs\",\"isPartOf\":{\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/#website\"},\"datePublished\":\"2017-02-16T16:26:19+00:00\",\"dateModified\":\"2022-07-01T17:44:13+00:00\",\"author\":{\"@type\":\"person\",\"name\":\"Bernardo Smaniotto\"},\"description\":\"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.\",\"breadcrumb\":{\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Code Review: Easier Better Faster Stronger\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/#website\",\"url\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/\",\"name\":\"Cheesecake Labs\",\"description\":\"Empresa de desenvolvimento e design de aplicativos mobile & web que est\u00e1 reinventando o desenvolvimento de produtos com times remotos. N\u00f3s desenvolvemos aplicativos iOS, Android e aplica\u00e7\u00f5es Web com as melhores empresas dos EUA, do Brasil e do mundo.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pt-BR\"},{\"@type\":\"Person\",\"name\":\"Bernardo Smaniotto\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2016\/11\/bernardo-300x300.jpg\",\"contentUrl\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2016\/11\/bernardo-300x300.jpg\",\"caption\":\"Bernardo Smaniotto\"},\"description\":\"10 years of experience in Marketing and Sales in the Technology sector. My main purpose is help, support and structure efficient operations and also develop independent and multidisciplinary teams.\",\"url\":\"https:\/\/blog-stg.cheesecakelabs.com\/br\/\/autor\/bernardo-smaniotto\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Code Review: Easier Better Faster Stronger | Cheesecake Labs","description":"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"pt_BR","og_type":"article","og_title":"Code Review: Easier Better Faster Stronger | Cheesecake Labs","og_description":"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.","og_url":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/","og_site_name":"Cheesecake Labs","article_publisher":"https:\/\/www.facebook.com\/cheesecakelabs","article_published_time":"2017-02-16T16:26:19+00:00","article_modified_time":"2022-07-01T17:44:13+00:00","og_image":[{"width":2000,"height":720,"url":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2017\/02\/Banner_betterforeview.png","type":"image\/png"}],"author":"Cheesecake Labs","twitter_card":"summary_large_image","twitter_creator":"@cheesecakelabs","twitter_site":"@cheesecakelabs","twitter_misc":{"Escrito por":null,"Est. tempo de leitura":"4 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/","url":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/","name":"Code Review: Easier Better Faster Stronger | Cheesecake Labs","isPartOf":{"@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/#website"},"datePublished":"2017-02-16T16:26:19+00:00","dateModified":"2022-07-01T17:44:13+00:00","author":{"@type":"person","name":"Bernardo Smaniotto"},"description":"Code Review is all about evaluating other people's code, resulting in software with better quality and wider involvement of the development team.","breadcrumb":{"@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/code-review-easier-better-faster-stronger\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog-stg.cheesecakelabs.com\/br\/"},{"@type":"ListItem","position":2,"name":"Code Review: Easier Better Faster Stronger"}]},{"@type":"WebSite","@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/#website","url":"https:\/\/blog-stg.cheesecakelabs.com\/br\/","name":"Cheesecake Labs","description":"Empresa de desenvolvimento e design de aplicativos mobile & web que est\u00e1 reinventando o desenvolvimento de produtos com times remotos. N\u00f3s desenvolvemos aplicativos iOS, Android e aplica\u00e7\u00f5es Web com as melhores empresas dos EUA, do Brasil e do mundo.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog-stg.cheesecakelabs.com\/br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"pt-BR"},{"@type":"Person","name":"Bernardo Smaniotto","image":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/blog-stg.cheesecakelabs.com\/br\/#\/schema\/person\/image\/","url":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2016\/11\/bernardo-300x300.jpg","contentUrl":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2016\/11\/bernardo-300x300.jpg","caption":"Bernardo Smaniotto"},"description":"10 years of experience in Marketing and Sales in the Technology sector. My main purpose is help, support and structure efficient operations and also develop independent and multidisciplinary teams.","url":"https:\/\/blog-stg.cheesecakelabs.com\/br\/\/autor\/bernardo-smaniotto\/"}]}},"_links":{"self":[{"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/posts\/4803","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/comments?post=4803"}],"version-history":[{"count":1,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/posts\/4803\/revisions"}],"predecessor-version":[{"id":10317,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/posts\/4803\/revisions\/10317"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/media\/9025"}],"wp:attachment":[{"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/media?parent=4803"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/categories?post=4803"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog-stg.cheesecakelabs.com\/br\/wp-json\/wp\/v2\/tags?post=4803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}