{"id":754,"date":"2022-08-18T19:57:25","date_gmt":"2022-08-18T17:57:25","guid":{"rendered":"https:\/\/renor.it\/first-the-comments-then-the-code\/"},"modified":"2025-12-20T15:53:36","modified_gmt":"2025-12-20T14:53:36","slug":"first-the-comments-then-the-code","status":"publish","type":"post","link":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/","title":{"rendered":"First the comments, then the code"},"content":{"rendered":"

In this article I want to talk about a topic that is very close to my heart and that many developers seem to leave on the back burner. This topic represents not only an undeniable \u201cbest practice\u201d in the way of developing code, but also a form of respect<\/strong> towards the community of developers and engineers who will have to put their hands back on code written by someone else: I am talking about code comments.<\/strong> <\/p>\n

A very dear university professor of mine, Prof. Carlo Gaibisso, used to say this phrase in his lectures on \u201cStructured Programming\u201d<\/em> in the C language: \u201cYou write the comments first and then the code.\u201d<\/em><\/p>\n

How can you blame them?<\/p>\n

Despite the fact that programmers are a class of \u201cstage animals\u201d<\/em> in the world of computer science, and despite the training a developer may have, it is a fact that it is always easier and more immediate to read something that belongs to our common way of communicating<\/strong>. It is much easier to read in Italian what an algorithm is about than to understand what an algorithm written in code does; it becomes the more complex to understand it the more complex the algorithm. <\/p>\n

Object-oriented programming also incorporates procedural programming. Within the methods of a class, one programs procedurally. <\/p>\n

Procedural programming is so called because code is executed according to a procedure<\/strong>. I can write procedures for anything… For example if I have to calculate the Fibonacci succession I know that to calculate the number at step n I have to <\/em>take the previous number and add it to the still previous number.
Therefore the procedure will be: starting with S = 1 1, f3<\/i>– <\/sub>> I take f2<\/sub> I add it to f1<\/sub>, and I get <\/p>\n

S = 1 1 2<\/p>\n

I take f3<\/sub> = 2 I add it to f2<\/sub> = 1 and get<\/p>\n

S = 1 1 2 3<\/p>\n

I take f4<\/sub> = 3 I add it to f2<\/sub> = 2 and get<\/p>\n

S = 1 1 2 3 5<\/p>\n

You will understand that it is much easier to instantly understand the definition, \u201cTo calculate the nth number of the Fibonacci sequence I add the previous two\u201d than fn<\/sub> = fn-1<\/sub> + fn-2<\/sub> especially if this formula is written with variables and cycles within a computer algorithm!<\/p>\n

PHP example for calculating Fibonacci series without comments<\/p>\n

[php]<br \/>
\n<?php<br \/>
\nclass Fibonacci<br \/>
\n{<br \/>
\n public static function calculateSuccession($n)<br \/>
\n {<br \/>
\n $n = $n – 2;<br \/>
\n $a = 1;<br \/>
\n $b = 1;<br \/>
\n echo $a . \u201c
\u201d;<br \/ >
\n echo $b . \u201c
\u201d;<br \/ >
\n for ($i = 0; $i < $n; $i++) {<br \/>
\n $c = $a + $b;<br \/>
\n echo $c . \u201c
\u201d;<br \/ >
\n $a = $b;<br \/>
\n $b = $c;<br \/>
\n }<br \/>
\n }<br \/>
\n}<\/p>
\n<p>Fibonacci::calculateSuccession(1000);<br \/>
\n[\/php]<\/p>\n

PHP example with comments<\/p>\n

[php]<br \/>
\n<?php<\/p>
\n<p>\/**<br \/>
\n * Fibonacci is a class for calculating the Fibonacci succession<br \/>
\n * and its verification<br \/>
\n *<br \/>
\n * Fibonacci is a class for calculating the Fibonacci succession<br \/>
\n * The verification of the golden ratio through the relationship between successive terms<br \/>
\n * verification by tartaglia triangle and verification by<br \/>
\n * Cassini, Catalani and D’Ocagne’s equalities<br \/>
\n *<br \/>
\n * @author Simone Renzi<br \/>
\n * @version 1.0<br \/>
\n * @access public<br \/>
\n * @see http:\/\/renor.it<br \/>
\n *<br \/>
\n **\/<br \/>
\nclass Fibonacci<br \/>
\n{<br \/>
\n \/**<br \/>
\n * @method calculateSuccession – Static method to calculate succession<br \/>
\n * of Fibonacci for $n terms<br \/>
\n * @param int $n – The number of iterations<br \/>
\n * @return void has no return values, it just prints the values<br \/>
\n * of the series at each iteration<br \/>
\n * @access public<br \/>
\n **\/<\/p>
\n<p> public static function calculateSuccession($n)<br \/>
\n {<br \/>
\n \/\/As I have two fixed parameters I remove them from iterations<br \/>
\n $n = $n – 2;<br \/>
\n $a = 1;<br \/>
\n $b = 1;<br \/>
\n \/\/Print the two starting parameters<br \/>
\n echo $a . \u201c
\u201d;<br \/ >
\n echo $b . \u201c
\u201d;<br \/ >
\n \/\/Cycle for $n<br \/>
\n for ($i = 0; $i < $n; $i++) {<br \/>
\n \/\/Calculate the value of the subsequence at step $n<br \/>
\n $c = $a + $b;<br \/>
\n \/\/Print on screen the value<br \/>
\n echo $c . \u201c
\u201d;<br \/ >
\n \/\/move variable values<br \/>
\n \/\/f2 becomes f1<br \/>
\n $a = $b;<br \/>
\n \/\/f3 becomes f2, the next iteration will calculate the new f3<br \/>
\n $b = $c;<br \/>
\n }<br \/>
\n }<br \/>
\n}<\/p>
\n<p>Fibonacci::calculateSuccession(1000);<br \/>
\n[\/php]<\/p>\n

I can continue to apply the procedure of taking the previous two numbers to infinity. Obviously computing an infinite set of numbers takes an infinite amount of time so we opt to find the subsequence at term n where <\/em> n is <\/em>the number of iterations for which the algorithm will have to perform the procedure. <\/p>\n

From the pictures we can see that writing commented code in a virtuous way requires many more lines and therefore more time but in case of maintenance everything will become extremely easier and faster. We invest a small part of our time before so that we do not have to waste whole days afterwards. <\/p>\n

Procedures<\/h2>\n

I can apply a procedure in any context, even for cooking. A recipe is nothing but a procedure: take a saucepan, put 2 tablespoons of extra virgin olive oil, add a clove of garlic, a hot pepper, turn on the stove and simmer, etc. <\/p>\n

Procedures are inherent within functions and can be combined to solve larger problems. Returning to the Fibonacci example, another algorithm might verify that the ratio between two consecutive numbers in the Fibonacci series approximates as n <\/em>increases more and <\/em>more the golden ratio. A further function could verify that the obtained succession of n<\/em> terms considering the of the terms on each diagonal of the tartaglia triangle corresponds to the Fibonacci succession, etc. <\/p>\n

On par I could say that the previous procedure useful for preparing the soffritto should be carried out on par with the procedure for cooking the pasta.<\/p>\n

As you may have realized, a procedure is best and most quickly understood if there are comments describing the steps.<\/p>\n

It is usual to insert comments first and then code because this practice allows us to write code very quickly without forgetting anything and leaving other programmers who will have to integrate other functions to quickly understand the famous \u201cwhat is needed for what.\u201d <\/em> <\/p>\n

 <\/p>\n\n

[starbox] <\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

In this article I want to talk about a topic that is very close to my heart and that many developers seem to leave on the back burner. This topic represents not only an undeniable \u201cbest practice\u201d in the way of developing code, but also a form of respect towards the community of developers and […]<\/p>\n","protected":false},"author":2,"featured_media":917,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_writerflow_disable_suggestions":false,"footnotes":""},"categories":[1977],"tags":[1676,1677,1678,1675,1679,1624,1625,1680],"class_list":["post-754","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sviluppo-software-programmazione","tag-code-comments","tag-comments","tag-importance-of-comments","tag-procedural-programming","tag-procedures","tag-renor-en","tag-renor-partners-en","tag-why-comment-on-the-code"],"acf":[],"yoast_head":"\nFirst the comments, then the code | RENOR & Partners S.r.l.<\/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:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"First the comments, then the code\" \/>\n<meta property=\"og:description\" content=\"In this article I want to talk about a topic that is very close to my heart and that many developers seem to leave on the back burner. This topic represents not only an undeniable \u201cbest practice\u201d in the way of developing code, but also a form of respect towards the community of developers and […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/\" \/>\n<meta property=\"og:site_name\" content=\"RENOR & Partners S.r.l.\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/renorsrl\" \/>\n<meta property=\"article:author\" content=\"https:\/\/www.facebook.com\/simone.renzi.3954\/\" \/>\n<meta property=\"article:published_time\" content=\"2022-08-18T17:57:25+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-12-20T14:53:36+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"675\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Simone Renzi\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Simone Renzi\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/\"},\"author\":{\"name\":\"Simone Renzi\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#\\\/schema\\\/person\\\/21343be04e5983a87f3a9a6182cf8795\"},\"headline\":\"First the comments, then the code\",\"datePublished\":\"2022-08-18T17:57:25+00:00\",\"dateModified\":\"2025-12-20T14:53:36+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/\"},\"wordCount\":1141,\"publisher\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2022\\\/08\\\/commenti-al-codice.jpg\",\"keywords\":[\"code comments\",\"comments\",\"importance of comments\",\"procedural programming\",\"procedures\",\"renor\",\"renor & partners\",\"why comment on the code\"],\"articleSection\":[\"Sviluppo Software & Programmazione\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/\",\"url\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/\",\"name\":\"First the comments, then the code | RENOR & Partners S.r.l.\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2022\\\/08\\\/commenti-al-codice.jpg\",\"datePublished\":\"2022-08-18T17:57:25+00:00\",\"dateModified\":\"2025-12-20T14:53:36+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#primaryimage\",\"url\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2022\\\/08\\\/commenti-al-codice.jpg\",\"contentUrl\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2022\\\/08\\\/commenti-al-codice.jpg\",\"width\":1200,\"height\":675,\"caption\":\"L'importanza di commentare il codice, una best practice innegabile nello sviluppo di codice e una forma di rispetto verso la comunit\u00e0 di professionisti programmatori\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/sviluppo-software-programmazione\\\/first-the-comments-then-the-code\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/renor.it\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Blog\",\"item\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Software Development & Programming\",\"item\":\"https:\\\/\\\/renor.it\\\/en\\\/blog\\\/software-development-programming\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"First the comments, then the code\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#website\",\"url\":\"https:\\\/\\\/renor.it\\\/en\\\/\",\"name\":\"RENOR & Partners S.r.l.\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#organization\"},\"alternateName\":\"RENOR & Partners S.r.l.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/renor.it\\\/en\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#organization\",\"name\":\"RENOR & Partners S.r.l.\",\"url\":\"https:\\\/\\\/renor.it\\\/en\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/logo-new-1.webp\",\"contentUrl\":\"https:\\\/\\\/renor.it\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/logo-new-1.webp\",\"width\":432,\"height\":146,\"caption\":\"RENOR & Partners S.r.l.\"},\"image\":{\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/renorsrl\",\"https:\\\/\\\/www.instagram.com\\\/renorpartners\\\/\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/renor-partners\\\/posts\\\/?feedView=all\"],\"description\":\"RENOR & Partners Srl \u00e8 una societ\u00e0 di consulenza tecnologica e ingegneristica specializzata in sviluppo software, cloud computing, integrazione di sistemi, intelligenza artificiale applicata e progettazione elettronica. L\u2019azienda supporta imprese e pubbliche amministrazioni nella realizzazione di soluzioni digitali affidabili, scalabili e orientate all\u2019efficienza, con un approccio pragmatico basato su competenze tecniche, progettazione su misura e innovazione concreta.\",\"email\":\"info@renor.it\",\"telephone\":\"3791489430\",\"legalName\":\"RENOR AND PARTNERS S.r.l.\",\"foundingDate\":\"2022-06-21\",\"vatID\":\"16768411007\",\"taxID\":\"16768411007\",\"numberOfEmployees\":{\"@type\":\"QuantitativeValue\",\"minValue\":\"1\",\"maxValue\":\"10\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/renor.it\\\/en\\\/#\\\/schema\\\/person\\\/21343be04e5983a87f3a9a6182cf8795\",\"name\":\"Simone Renzi\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g\",\"caption\":\"Simone Renzi\"},\"description\":\"Senior full-stack web engineer with over 20 years of experience in cloud architectures, AI, and SaaS solutions; member of Mensa Italia. Creator of platforms such as HR24.ai and Paghe.ai, he oversaw the web development of FNS, a neural network simulator cited in Scientific Reports (Nature Portfolio), and has collaborated on research projects with INFN \u2013 Laboratori Nazionali di Frascati, Universit\u00e0 di Roma \u201cTor Vergata\u201d, Universidad Complutense, Universidad Polit\u00e9cnica and Centro de Tecnolog\u00eda Biom\u00e9dica in Madrid. A classical pianist, he combines musical creativity and technological rigor in every project.\",\"sameAs\":[\"https:\\\/\\\/renor.it\",\"https:\\\/\\\/www.facebook.com\\\/simone.renzi.3954\\\/\",\"https:\\\/\\\/www.linkedin.com\\\/in\\\/simone-renzi\"],\"url\":\"https:\\\/\\\/renor.it\\\/en\\\/author\\\/thesimon\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"First the comments, then the code | RENOR & Partners S.r.l.","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:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/","og_locale":"en_US","og_type":"article","og_title":"First the comments, then the code","og_description":"In this article I want to talk about a topic that is very close to my heart and that many developers seem to leave on the back burner. This topic represents not only an undeniable \u201cbest practice\u201d in the way of developing code, but also a form of respect towards the community of developers and […]","og_url":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/","og_site_name":"RENOR & Partners S.r.l.","article_publisher":"https:\/\/www.facebook.com\/renorsrl","article_author":"https:\/\/www.facebook.com\/simone.renzi.3954\/","article_published_time":"2022-08-18T17:57:25+00:00","article_modified_time":"2025-12-20T14:53:36+00:00","og_image":[{"width":1200,"height":675,"url":"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg","type":"image\/jpeg"}],"author":"Simone Renzi","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Simone Renzi","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#article","isPartOf":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/"},"author":{"name":"Simone Renzi","@id":"https:\/\/renor.it\/en\/#\/schema\/person\/21343be04e5983a87f3a9a6182cf8795"},"headline":"First the comments, then the code","datePublished":"2022-08-18T17:57:25+00:00","dateModified":"2025-12-20T14:53:36+00:00","mainEntityOfPage":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/"},"wordCount":1141,"publisher":{"@id":"https:\/\/renor.it\/en\/#organization"},"image":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#primaryimage"},"thumbnailUrl":"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg","keywords":["code comments","comments","importance of comments","procedural programming","procedures","renor","renor & partners","why comment on the code"],"articleSection":["Sviluppo Software & Programmazione"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/","url":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/","name":"First the comments, then the code | RENOR & Partners S.r.l.","isPartOf":{"@id":"https:\/\/renor.it\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#primaryimage"},"image":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#primaryimage"},"thumbnailUrl":"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg","datePublished":"2022-08-18T17:57:25+00:00","dateModified":"2025-12-20T14:53:36+00:00","breadcrumb":{"@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#primaryimage","url":"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg","contentUrl":"https:\/\/renor.it\/wp-content\/uploads\/2022\/08\/commenti-al-codice.jpg","width":1200,"height":675,"caption":"L'importanza di commentare il codice, una best practice innegabile nello sviluppo di codice e una forma di rispetto verso la comunit\u00e0 di professionisti programmatori"},{"@type":"BreadcrumbList","@id":"https:\/\/renor.it\/en\/blog\/sviluppo-software-programmazione\/first-the-comments-then-the-code\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/renor.it\/en\/"},{"@type":"ListItem","position":2,"name":"Blog","item":"https:\/\/renor.it\/en\/blog\/"},{"@type":"ListItem","position":3,"name":"Software Development & Programming","item":"https:\/\/renor.it\/en\/blog\/software-development-programming\/"},{"@type":"ListItem","position":4,"name":"First the comments, then the code"}]},{"@type":"WebSite","@id":"https:\/\/renor.it\/en\/#website","url":"https:\/\/renor.it\/en\/","name":"RENOR & Partners S.r.l.","description":"","publisher":{"@id":"https:\/\/renor.it\/en\/#organization"},"alternateName":"RENOR & Partners S.r.l.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/renor.it\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/renor.it\/en\/#organization","name":"RENOR & Partners S.r.l.","url":"https:\/\/renor.it\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/renor.it\/en\/#\/schema\/logo\/image\/","url":"https:\/\/renor.it\/wp-content\/uploads\/2025\/12\/logo-new-1.webp","contentUrl":"https:\/\/renor.it\/wp-content\/uploads\/2025\/12\/logo-new-1.webp","width":432,"height":146,"caption":"RENOR & Partners S.r.l."},"image":{"@id":"https:\/\/renor.it\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/renorsrl","https:\/\/www.instagram.com\/renorpartners\/","https:\/\/www.linkedin.com\/company\/renor-partners\/posts\/?feedView=all"],"description":"RENOR & Partners Srl \u00e8 una societ\u00e0 di consulenza tecnologica e ingegneristica specializzata in sviluppo software, cloud computing, integrazione di sistemi, intelligenza artificiale applicata e progettazione elettronica. L\u2019azienda supporta imprese e pubbliche amministrazioni nella realizzazione di soluzioni digitali affidabili, scalabili e orientate all\u2019efficienza, con un approccio pragmatico basato su competenze tecniche, progettazione su misura e innovazione concreta.","email":"info@renor.it","telephone":"3791489430","legalName":"RENOR AND PARTNERS S.r.l.","foundingDate":"2022-06-21","vatID":"16768411007","taxID":"16768411007","numberOfEmployees":{"@type":"QuantitativeValue","minValue":"1","maxValue":"10"}},{"@type":"Person","@id":"https:\/\/renor.it\/en\/#\/schema\/person\/21343be04e5983a87f3a9a6182cf8795","name":"Simone Renzi","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/54f81b51be6bda6d63a06a1cd6563d9b0d5778d7af4f0bda4e246fc3e5737e2e?s=96&d=mm&r=g","caption":"Simone Renzi"},"description":"Senior full-stack web engineer with over 20 years of experience in cloud architectures, AI, and SaaS solutions; member of Mensa Italia. Creator of platforms such as HR24.ai and Paghe.ai, he oversaw the web development of FNS, a neural network simulator cited in Scientific Reports (Nature Portfolio), and has collaborated on research projects with INFN \u2013 Laboratori Nazionali di Frascati, Universit\u00e0 di Roma \u201cTor Vergata\u201d, Universidad Complutense, Universidad Polit\u00e9cnica and Centro de Tecnolog\u00eda Biom\u00e9dica in Madrid. A classical pianist, he combines musical creativity and technological rigor in every project.","sameAs":["https:\/\/renor.it","https:\/\/www.facebook.com\/simone.renzi.3954\/","https:\/\/www.linkedin.com\/in\/simone-renzi"],"url":"https:\/\/renor.it\/en\/author\/thesimon\/"}]}},"_links":{"self":[{"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/posts\/754","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/comments?post=754"}],"version-history":[{"count":0,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/posts\/754\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/media\/917"}],"wp:attachment":[{"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/media?parent=754"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/categories?post=754"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/renor.it\/en\/wp-json\/wp\/v2\/tags?post=754"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}