{"id":333,"date":"2017-07-19T14:00:28","date_gmt":"2017-07-19T12:00:28","guid":{"rendered":"https:\/\/jm.garreta.eu\/blog\/?p=333"},"modified":"2017-07-19T14:00:28","modified_gmt":"2017-07-19T12:00:28","slug":"sans-commentaire","status":"publish","type":"post","link":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/","title":{"rendered":"Sans commentaire"},"content":{"rendered":"<p><a href=\"https:\/\/testing.googleblog.com\/2017\/07\/code-health-to-comment-or-not-to-comment.html\" target=\"_blank\" rel=\"noopener\">Google<\/a> apporte son point de vue sur l&rsquo;usage des fois trop exag\u00e9r\u00e9 des commentaires.<\/p>\n<p>J&rsquo;ai eu un stagiaire une fois qui \u00e9tait surpris du peu de commentaire dans un de mes codes. Je lui ai demand\u00e9 en regardant plus en d\u00e9tail ce que je pouvais commenter car mes noms de fonctions, de variables \u00e9taient suffisants.<\/p>\n<p>J&rsquo;ai un coll\u00e8gue qui use et abuse des commentaires. Quel int\u00e9r\u00eat de ce type par exemple ?<\/p>\n<p><code>\/\/ Get all users.<br \/>\nuserService.getAllUsers();<\/code><\/p>\n<p>A utiliser avec pr\u00e9caution.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-medium wp-image-334\" src=\"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg\" alt=\"\" width=\"300\" height=\"188\" srcset=\"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg 300w, https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-768x480.jpg 768w, https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-1024x640.jpg 1024w, https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2.jpg 1131w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/p>\n<p><a href=\"https:\/\/www.developpez.com\/actu\/150066\/Programmation-quand-faut-il-commenter-son-code-Google-s-invite-dans-le-debat-et-montre-que-les-commentaires-peuvent-tres-souvent-etre-evites\/\" target=\"_blank\" rel=\"noopener\">Source<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Google apporte son point de vue sur l&rsquo;usage des fois trop exag\u00e9r\u00e9 des commentaires. J&rsquo;ai eu un stagiaire une fois qui \u00e9tait surpris du peu de commentaire dans un de mes codes. Je lui ai demand\u00e9 en regardant plus en d\u00e9tail ce que je pouvais commenter car mes noms de fonctions, de variables \u00e9taient suffisants. &hellip; <a href=\"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/\" class=\"more-link\">Continuer la lecture de <span class=\"screen-reader-text\">Sans commentaire<\/span>  <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"blog_gen_system_prompt":"","blog_gen_user_prompt":"","blog_gen_featured_img_prompt":"","blog_gen_inline_img_prompts":"","blog_gen_model":"","blog_gen_image_model":"","blog_gen_timestamp":"","blog_gen_type_article":"","blog_gen_longueur_cible":"","footnotes":""},"categories":[3],"tags":[216,215,91,69],"class_list":["post-333","post","type-post","status-publish","format-standard","hentry","category-informatique","tag-code-source","tag-comment","tag-commentaire","tag-programmation"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Sans commentaire - Le blog de Jean-Mich<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Sans commentaire - Le blog de Jean-Mich\" \/>\n<meta property=\"og:description\" content=\"Google apporte son point de vue sur l&rsquo;usage des fois trop exag\u00e9r\u00e9 des commentaires. J&rsquo;ai eu un stagiaire une fois qui \u00e9tait surpris du peu de commentaire dans un de mes codes. Je lui ai demand\u00e9 en regardant plus en d\u00e9tail ce que je pouvais commenter car mes noms de fonctions, de variables \u00e9taient suffisants. &hellip; Continuer la lecture de Sans commentaire &rarr;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/\" \/>\n<meta property=\"og:site_name\" content=\"Le blog de Jean-Mich\" \/>\n<meta property=\"article:published_time\" content=\"2017-07-19T12:00:28+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg\" \/>\n<meta name=\"author\" content=\"jeanmich\" \/>\n<meta name=\"twitter:label1\" content=\"\u00c9crit par\" \/>\n\t<meta name=\"twitter:data1\" content=\"jeanmich\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/\"},\"author\":{\"name\":\"jeanmich\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/#\\\/schema\\\/person\\\/5ed151f48f77a878fc9d3868c8a1ed7d\"},\"headline\":\"Sans commentaire\",\"datePublished\":\"2017-07-19T12:00:28+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/\"},\"wordCount\":87,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/wp-content\\\/uploads\\\/2017\\\/07\\\/no-comment__n5x4v2-300x188.jpg\",\"keywords\":[\"code source\",\"comment\",\"commentaire\",\"programmation\"],\"articleSection\":[\"Informatique\"],\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/\",\"url\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/\",\"name\":\"Sans commentaire - Le blog de Jean-Mich\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/wp-content\\\/uploads\\\/2017\\\/07\\\/no-comment__n5x4v2-300x188.jpg\",\"datePublished\":\"2017-07-19T12:00:28+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/#\\\/schema\\\/person\\\/5ed151f48f77a878fc9d3868c8a1ed7d\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#primaryimage\",\"url\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/wp-content\\\/uploads\\\/2017\\\/07\\\/no-comment__n5x4v2.jpg\",\"contentUrl\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/wp-content\\\/uploads\\\/2017\\\/07\\\/no-comment__n5x4v2.jpg\",\"width\":1131,\"height\":707},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/sans-commentaire\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sans commentaire\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/\",\"name\":\"Le blog de Jean-Mich\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/#\\\/schema\\\/person\\\/5ed151f48f77a878fc9d3868c8a1ed7d\",\"name\":\"jeanmich\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g\",\"caption\":\"jeanmich\"},\"url\":\"https:\\\/\\\/jm.garreta.eu\\\/blog\\\/author\\\/jeanmich\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Sans commentaire - Le blog de Jean-Mich","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/","og_locale":"fr_FR","og_type":"article","og_title":"Sans commentaire - Le blog de Jean-Mich","og_description":"Google apporte son point de vue sur l&rsquo;usage des fois trop exag\u00e9r\u00e9 des commentaires. J&rsquo;ai eu un stagiaire une fois qui \u00e9tait surpris du peu de commentaire dans un de mes codes. Je lui ai demand\u00e9 en regardant plus en d\u00e9tail ce que je pouvais commenter car mes noms de fonctions, de variables \u00e9taient suffisants. &hellip; Continuer la lecture de Sans commentaire &rarr;","og_url":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/","og_site_name":"Le blog de Jean-Mich","article_published_time":"2017-07-19T12:00:28+00:00","og_image":[{"url":"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg","type":"","width":"","height":""}],"author":"jeanmich","twitter_misc":{"\u00c9crit par":"jeanmich"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#article","isPartOf":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/"},"author":{"name":"jeanmich","@id":"https:\/\/jm.garreta.eu\/blog\/#\/schema\/person\/5ed151f48f77a878fc9d3868c8a1ed7d"},"headline":"Sans commentaire","datePublished":"2017-07-19T12:00:28+00:00","mainEntityOfPage":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/"},"wordCount":87,"commentCount":0,"image":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#primaryimage"},"thumbnailUrl":"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg","keywords":["code source","comment","commentaire","programmation"],"articleSection":["Informatique"],"inLanguage":"fr-FR","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/","url":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/","name":"Sans commentaire - Le blog de Jean-Mich","isPartOf":{"@id":"https:\/\/jm.garreta.eu\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#primaryimage"},"image":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#primaryimage"},"thumbnailUrl":"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2-300x188.jpg","datePublished":"2017-07-19T12:00:28+00:00","author":{"@id":"https:\/\/jm.garreta.eu\/blog\/#\/schema\/person\/5ed151f48f77a878fc9d3868c8a1ed7d"},"breadcrumb":{"@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/"]}]},{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#primaryimage","url":"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2.jpg","contentUrl":"https:\/\/jm.garreta.eu\/blog\/wp-content\/uploads\/2017\/07\/no-comment__n5x4v2.jpg","width":1131,"height":707},{"@type":"BreadcrumbList","@id":"https:\/\/jm.garreta.eu\/blog\/sans-commentaire\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/jm.garreta.eu\/blog\/"},{"@type":"ListItem","position":2,"name":"Sans commentaire"}]},{"@type":"WebSite","@id":"https:\/\/jm.garreta.eu\/blog\/#website","url":"https:\/\/jm.garreta.eu\/blog\/","name":"Le blog de Jean-Mich","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jm.garreta.eu\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Person","@id":"https:\/\/jm.garreta.eu\/blog\/#\/schema\/person\/5ed151f48f77a878fc9d3868c8a1ed7d","name":"jeanmich","image":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/secure.gravatar.com\/avatar\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/816266d852c4595a2bfa578a991fa68bb8ed5e0217f3565158ca20c139873bda?s=96&d=mm&r=g","caption":"jeanmich"},"url":"https:\/\/jm.garreta.eu\/blog\/author\/jeanmich\/"}]}},"_links":{"self":[{"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/posts\/333","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/comments?post=333"}],"version-history":[{"count":1,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/posts\/333\/revisions"}],"predecessor-version":[{"id":335,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/posts\/333\/revisions\/335"}],"wp:attachment":[{"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/media?parent=333"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/categories?post=333"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jm.garreta.eu\/blog\/wp-json\/wp\/v2\/tags?post=333"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}