{"id":35684,"date":"2022-08-05T01:10:56","date_gmt":"2022-08-05T05:10:56","guid":{"rendered":"https:\/\/101blockchains.com\/?p=35684"},"modified":"2025-03-17T01:08:30","modified_gmt":"2025-03-17T05:08:30","slug":"comments-in-solidity","status":"publish","type":"post","link":"https:\/\/101blockchains.com\/comments-in-solidity\/","title":{"rendered":"What Are Comments In Solidity and Why It Is Important"},"content":{"rendered":"<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\"><a href=\"https:\/\/101blockchains.com\/solidity-tutorial\/\" target=\"_blank\" rel=\"noopener\">Solidity<\/a> is one of the most popular entries among programming languages for <a href=\"https:\/\/101blockchains.com\/smart-contract-development-course-launched\/\" target=\"_blank\" rel=\"noopener\">smart contract development<\/a>. Many aspiring developers want to learn about the best practices for using the contract-oriented programming language. Therefore, the interest in\u00a0<\/span>Solidity comments<span style=\"font-weight: 400;\">\u00a0is also one of the priorities for people interested in developing <a href=\"https:\/\/101blockchains.com\/decentralization-in-blockchain\/\" target=\"_blank\" rel=\"noopener\">decentralized<\/a>, <a href=\"https:\/\/101blockchains.com\/smart-contracts\/\" target=\"_blank\" rel=\"noopener\">smart contract<\/a>-based applications. At the same time, it is also important to wonder about the reasons for learning about\u00a0<\/span>comments in Solidity<span style=\"font-weight: 400;\">\u00a0and their importance.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The following discussion offers you a detailed introduction to comments in the Solidity programming language and its variants. You can learn about the benefits of comments in a programming language and the examples of documentation for comments with the Solidity programming language.<\/span><\/p>\n<blockquote><p>Are you aspiring to learn the fundamentals of the Ethereum Virtual Machine and smart contracts\u2019 upgradability? Enroll now in the\u00a0<a href=\"https:\/\/101blockchains.com\/course\/advanced-solidity-development\/\" target=\"_blank\" rel=\"noopener\" data-wpel-link=\"internal\">Advanced Solidity Development Course<\/a>.<\/p><\/blockquote>\n<h2><b>What are Comments?<\/b><\/h2>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">Comments basically refer to a description for a specific line or block of code, which can help developers in a better understanding of the code. It is not only meant for developers but also to make the smart contract code readable for end users. The necessity of\u00a0<\/span>Solidity comments dev<span style=\"font-weight: 400;\"> processes is important to understand the code in the first place. Even the developers can experience difficulties in understanding code without any comments. Therefore, comments are an integral part of any programming language, especially a critical choice like Solidity for developing smart contracts. On the other hand, there are many people who believe that comments are a redundant highlight in programming. Such schools of thought encourage simplifying the code for human understanding rather than writing comments to describe code.<\/span><\/p>\n<blockquote><p>Build your identity as a certified blockchain expert with 101 Blockchains\u2019\u00a0<a href=\"https:\/\/101blockchains.com\/certifications\/\" target=\"_blank\" rel=\"noopener\" data-wpel-link=\"internal\">Blockchain Certifications<\/a>\u00a0designed to provide enhanced career prospects.<\/p><\/blockquote>\n<h3><b>Why Do People Avoid Comments?<\/b><\/h3>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">When you are trying to learn the answers to \u201c<\/span>What are comments in Solidity<span style=\"font-weight: 400;\">,\u201d you can find doubts about using comments. Your doubts may get stronger with the reasons suggested by people for avoiding comments in their Solidity code. Writing a simpler code is more of an alternative rather than an explanation to avoiding comments. What could be the possible reasons for which developers would avoid comments?\u00a0<\/span><\/p>\n<ul style=\"text-align: justify;\">\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">One of the first reasons to show why\u00a0<\/span>Solidity comments dev<span style=\"font-weight: 400;\">\u00a0processes are missing is the need for brainpower to write and maintain comments. It is difficult for many developers to explain the objective of an algorithm or function in simple comments after spending prolonged sessions debugging.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The next important reason for which developers might choose to avoid comments in their smart contract code refers to the lack of skills. <a href=\"https:\/\/101blockchains.com\/solidity-developer\/\" target=\"_blank\" rel=\"noopener\">Solidity developers<\/a> can experience challenges in explaining the intent and reasoning behind their code in simple English language. As a result, they tend to avoid comments as long as the code works fine.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Another possible reason for avoiding\u00a0<\/span>comments in Solidity<span style=\"font-weight: 400;\">\u00a0would refer to the limited understanding of underlying mechanics in specific portions of the code. You can identify that the lack of understanding about specific parts of the code could induce the inability to explain the concerned part of the code. Ultimately, developers find it quite cumbersome to write comments after extensive development and testing sessions, especially when they cannot understand how the code works from the inside.\u00a0<\/span><\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The reasons for which people don\u2019t comment on codes in Solidity show that lack of comments can ultimately land developers with critical problems at later stages. Solidity is an important programming language for smart scripting contracts and defining the code used for executing the contracts and <a href=\"https:\/\/101blockchains.com\/what-is-dapp\/\" target=\"_blank\" rel=\"noopener\">decentralized application<\/a> functionalities. Leaving out\u00a0<\/span>Solidity comments<span style=\"font-weight: 400;\"> by subscribing to specific schools of thought cannot deliver any conclusive advantage to developers. On the contrary, developers must recognize the importance of comments in the functionalities of a programming language.<\/span><\/p>\n<blockquote><p>Learn the process of creating and deploying smart contracts on the Ethereum blockchain with the\u00a0<a href=\"https:\/\/101blockchains.com\/course\/solidity-fundamentals\/\" target=\"_blank\" rel=\"noopener\" data-wpel-link=\"internal\">Solidity Fundamentals Course<\/a>.<\/p><\/blockquote>\n<h2><b>Importance of Comments in Solidity\u00a0<\/b><\/h2>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The important aspect of the guide to comments on Solidity programming language would turn the limelight towards their significance. How do comments deliver any form of value for Solidity developers?\u00a0<\/span>Why are Solidity comments important<span style=\"font-weight: 400;\">, and how can they help developers? Here are some of the notable advantages of Solidity every smart contract developer should consider before using Solidity to create smart contracts.\u00a0<\/span><\/p>\n<p><picture><source srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity.webp 1200w,https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-300x300.webp 300w,https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-1024x1024.webp 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-150x150.png 150w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-768x768.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" type=\"image\/webp\"><img src=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity.png\" height=\"1200\" width=\"1200\" srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity.png 1200w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-300x300.png 300w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-1024x1024.png 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-150x150.png 150w, https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/Importance-of-Comments-in-Solidity-768x768.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" class=\"alignleft size-full wp-image-35781 sp-no-webp\" alt=\"Importance of Comments in Solidity\" loading=\"lazy\" decoding=\"async\"  > <\/picture><\/p>\n<ul>\n<li aria-level=\"1\">\n<h3><b>Time Saving<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The foremost benefit of adding comments in your Solidity programming code is time-saving. You can save a considerable amount of time by avoiding confusion about the reasons for which a specific portion of the code fails in the compilation. Developers can comment on their Solidity code and save time by identifying the working of the code quickly. The comments can also serve as useful guidance or benchmarks for future developers to make changes or improvements to the project.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>A Pseudo-code<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The addition of\u00a0<\/span>comments in Solidity<span style=\"font-weight: 400;\">\u00a0programming language also serves as a type of pseudo-code. You can build your app around the pseudo-code with an understanding of the type of functions you want and where you should place them in your Solidity code. The comments can serve comprehensive insights regarding the mechanisms of a specific block of code.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Isolate the Important Blocks of Code<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">You can know \u2018<\/span>what are comments in Solidity<span style=\"font-weight: 400;\">\u2019 and more about their importance on the grounds of isolating important blocks of code. Remember that Solidity programs might have specific portions which are integral to the functioning of the whole code. Any type of alterations in the concerned part could affect the outcomes of the code. Therefore, comments can help you avoid unwanted troubles in the future when you might have to upgrade the Solidity code. The warning comments for specific lines of code could help in avoiding unwanted changes which might affect the intent of the whole program.<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Maintaining Track of Tasks\u00a0<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The functionalities of\u00a0<\/span>Solidity comments in the dev<span style=\"font-weight: 400;\">\u00a0experience would also provide facilities for commenting within the code. It can help in discovering the subsequent tasks you need to achieve within your <a href=\"https:\/\/101blockchains.com\/what-is-a-smart-contract\/\" target=\"_blank\" rel=\"noopener\">smart contract<\/a> or <a href=\"https:\/\/101blockchains.com\/what-is-dapp\/\" target=\"_blank\" rel=\"noopener\">decentralized application<\/a>. The comments will help you stay in the right direction with a natural order of process flow.<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Addition of Context<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The work of comments in the <a href=\"https:\/\/101blockchains.com\/solidity-tutorial\/\" target=\"_blank\" rel=\"noopener\">Solidity<\/a> programming language is not limited only to the explanation of content in the code. Comments show what a specific line of code means and its function. At the same time, comments also deliver clarity regarding the way a particular line or block of code works for the complete application. Basically, you can figure out the significance of the block of code in the overall smart contract or decentralized applications. With a simple and explicit description of functionalities, comments can ensure that you don\u2019t have any confusion about deleting specific <a href=\"https:\/\/101blockchains.com\/blockchain-nodes\/\" target=\"_blank\" rel=\"noopener\">nodes<\/a>.<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Explanation of the Developer\u2019s Perspective<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The most significant reason for using\u00a0<\/span>Solidity comments<span style=\"font-weight: 400;\">\u00a0refers to the clear glimpse of the developer\u2019s perspective. Comments in the smart contract or decentralized application code written in Solidity can show why the developer has scripted the comments that way. Some of the methods used by Solidity developers in their code might not be clear to many. In such cases, the comments can help in understanding the reasons behind the developer\u2019s choices. Furthermore, comments can help in understanding the reasons behind the working of a particular method in the code. You can also anticipate the reasons for which developers choose different methods than the recommended options.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Markers for Improvements\u00a0<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">Another formidable reason for using\u00a0<\/span>Solidity comments in dev<span style=\"font-weight: 400;\">\u00a0processes would refer to the access to bookmarks for improvement. If you are having trouble with a specific line of code, then you can mark it with a comment so that you can return back to it later.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h3><b>Additional Information<\/b><\/h3>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The reasons for using comments in almost any programming language, especially Solidity, would also focus on adding extra information. Comments could serve a significant purpose in highlighting the title of the application or author of the software and, most important of all, the last date of update. Solidity developers can use comments as a flexible instrument for highlighting the last update date and the authority responsible.\u00a0<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The answers to \u201c<\/span>Why Solidity comments are important<span style=\"font-weight: 400;\">\u201d offer a reflection of the credibility of developers. Comments show that you are prepared to travel the extra mile to make your code human-readable and understandable for everyone. By adding comments, Solidity developers can offer a guide on using the code in the present as well as in the future. Above everything else, comments on the Solidity code showcase the intent of developers behind creating the solution.<\/span><\/p>\n<p><a href=\"https:\/\/101blockchains.com\/certification\/blockchain-expert-certification\/\" target=\"_blank\" rel=\"noopener\"><picture><source srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1.webp 1200w,https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-300x23.webp 300w,https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-1024x77.webp 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-768x58.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" type=\"image\/webp\"><img src=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1.png\" height=\"90\" width=\"1200\" srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1.png 1200w, https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-300x23.png 300w, https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-1024x77.png 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/05\/Certified-Enterprise-Blockchain-Professional-1-768x58.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" class=\"aligncenter wp-image-43445 size-full sp-no-webp\" alt=\"certified enterprise blockchain professional\" loading=\"lazy\" decoding=\"async\"  > <\/picture><\/a><\/p>\n<h3><b>Types of Comments in Solidity<\/b><\/h3>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">Any guide on\u00a0<\/span>Solidity comments<span style=\"font-weight: 400;\">\u00a0would showcase a formidable impression of how they can help in improving code maintenance. At the same time, it is also important to learn about the different variants of comments you can find in Solidity. The two notable categories of comments in the documentation of Solidity refer to regular comments and NatSpec comments. Regular comments are further classified into a single line and multiline comments. It is also important to note that the compiler can ignore comments text and does not translate it into byte code as other parts of the code. Let us learn more about each type of comment in Solidity programming language.\u00a0<\/span><\/p>\n<h4><b>Regular Comments<\/b><\/h4>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">Regular comments are the common code comments you can use in Solidity for documentation of your code base. Such types of comments are considered useful for driving better understanding and maintenance of code base through other developers. The two popular types of regular comments refer to a single line or inline comments and multiline or block line comments. Here is an overview of the two types of regular comments and their general syntax example.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h5><b>Single Line Comments<\/b><\/h5>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The single-line comments or inline comments are always added in the form of a new line or inline manner for the code. It is also important to identify that single-line comments must begin with a double forward slash symbol, i.e., \u201c\/\/,\u201d and the text content would follow afterward. Here is the syntax example for adding a single-line comment in Solidity smart contracts.<\/span><\/p>\n<pre style=\"text-align: justify;\"><span style=\"font-weight: 400;\">\/\/ Single line comment example<\/span><\/pre>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<h5><b>Multiline or Block Line Comments<\/b><\/h5>\n<\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The multiline or block line comments are the next important category among regular\u00a0<\/span>comments in Solidity<span style=\"font-weight: 400;\">\u00a0programming language. In the case of multiline comments, the text of the comments could cover multiple lines. They are also referred to as block-level comments. The method to writing Solidity multiline comments involves beginning with a \u201c\/*\u201d and including the comment text in multiple lines. The comment ends with the \u201c*\/\u201d annotation. You can take a look at the following syntax example to check how to write multiline comments<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">\/*<\/span> <span style=\"font-weight: 400;\">*<\/span> <span style=\"font-weight: 400;\">* multiline comment line1<\/span> <span style=\"font-weight: 400;\">* multiline comment line2<\/span> <span style=\"font-weight: 400;\">*\/<br \/>\n<\/span><\/p>\n<blockquote><p>Master the art of Smart Contract development with Solidity to create innovative web3 applications for diverse use cases as a Solidity expert with\u00a0<a href=\"https:\/\/101blockchains.com\/skill\/solidity\/\" target=\"_blank\" rel=\"noopener\" data-wpel-link=\"internal\">Solidity Skill Path<\/a><\/p><\/blockquote>\n<h4><b>NatSpec Comments<\/b><\/h4>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The answers to \u201c<\/span>What are comments in Solidity<span style=\"font-weight: 400;\">\u201d would also draw attention to the special form of comments evident in the form of NatSpec comments. Solidity smart contracts could leverage these special comments to facilitate comprehensive documentation for return variables, functions, and many other aspects. The NatSpec comments basically follow the <a href=\"https:\/\/101blockchains.com\/ultimate-ethereum-guide\/\" target=\"_blank\" rel=\"noopener\">Ethereum<\/a> Natural Language Specification Format, and the design has been drawn from Doxygen. At the same time,\u00a0<\/span>Solidity comments<span style=\"font-weight: 400;\">\u00a0don\u2019t have to comply with the compatibility requirements for Doxygen. Developers have also recommended that Solidity contracts must feature complete annotation by leveraging the NatSpec format. In addition, it includes formats for comments that the <a href=\"https:\/\/101blockchains.com\/what-is-a-smart-contract\/\" target=\"_blank\" rel=\"noopener\">smart contract<\/a> author could use. The NatSpec format would also feature annotations leveraged by third-party tools. Developers can make the most of tags, which are optional although featuring multiple functions. The notable tags include the following mentions,\u00a0<\/span><\/p>\n<ul style=\"text-align: justify;\">\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@title<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@author\u00a0 \u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@notice<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@dev<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@param<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@return<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@inherit<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">@custom:<\/span><\/li>\n<\/ul>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">In addition, the NatSpec comments would use the Solidity compiler for processing NatSpec documentation from the Solidity source code.<\/span><\/p>\n<blockquote><p>Excited to learn the basic and advanced concepts of ethereum technology? Enroll Now in <a href=\"https:\/\/101blockchains.com\/course\/ethereum-technology-course\/\" target=\"_blank\" rel=\"noopener\">The Complete Ethereum Technology Course<\/a><\/p><\/blockquote>\n<h3><b>Final Words<\/b><\/h3>\n<p style=\"text-align: justify;\"><span style=\"font-weight: 400;\">The details regarding the definition of comments and \u201c<\/span>why Solidity comments are important<span style=\"font-weight: 400;\">\u201d showcase the significance of comments. <a href=\"https:\/\/101blockchains.com\/solidity-tutorial\/\" target=\"_blank\" rel=\"noopener\">Solidity<\/a> is a popular choice for smart contract developers, especially considering the volume of <a href=\"https:\/\/101blockchains.com\/what-is-dapp\/\" target=\"_blank\" rel=\"noopener\">decentralized applications<\/a> on Ethereum. Comments are often perceived as a redundant highlight of the Solidity code, and some developers may find it tiresome to simplify their intent and purpose in plain English. However, comments serve a far more important role than explaining the objective and functions of different lines and blocks of code.\u00a0<\/span>Comments in Solidity<span style=\"font-weight: 400;\">\u00a0are an essential requirement for tracking the progress of developing the concerned smart contract or decentralized application. In addition, comments can also help developers recognize the important blocks of code which should not be altered. Learn more about the Solidity programming language and how it can help <a href=\"https:\/\/101blockchains.com\/become-smart-contract-developer\/\" target=\"_blank\" rel=\"noopener\">smart contract developers<\/a>.\u00a0<\/span><\/p>\n<p><a href=\"https:\/\/101blockchains.com\/pricing\/\" target=\"_blank\" rel=\"noopener\"><picture><source srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs.webp 1200w,https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-300x25.webp 300w,https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-1024x85.webp 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-768x64.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" type=\"image\/webp\"><img src=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs.png\" height=\"100\" width=\"1200\" srcset=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs.png 1200w, https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-300x25.png 300w, https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-1024x85.png 1024w, https:\/\/101blockchains.com\/wp-content\/uploads\/2023\/01\/Unlock-your-career-with-101-Blockchains-Learning-Programs-768x64.png 768w\" sizes=\"auto, (max-width: 1200px) 100vw, 1200px\" class=\"aligncenter wp-image-43615 size-full sp-no-webp\" alt=\"Unlock your career with 101 Blockchains&#039; Learning Programs\" loading=\"lazy\" decoding=\"async\"  > <\/picture><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Solidity is one of the most popular entries among programming languages for smart contract development. Many aspiring developers want to learn about the best practices for using the contract-oriented programming language. Therefore, the interest in\u00a0Solidity comments\u00a0is also one of the priorities for people interested in developing decentralized, smart contract-based applications. At the same time, it<\/p>\n<div class=\"read-more\"><a href=\"https:\/\/101blockchains.com\/comments-in-solidity\/\" title=\"Read More\">Read More<\/a><\/div>\n","protected":false},"author":64,"featured_media":35687,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1881],"tags":[],"class_list":{"0":"post-35684","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-solidity-smart-contracts"},"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.5 (Yoast SEO v27.5) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>What Are Comments In Solidity and Why It Is Important - 101 Blockchains<\/title>\n<meta name=\"description\" content=\"Solidity is an easy smart contract development programming language with multiple features. Learn more about comments in Solidity and their importance now.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/101blockchains.com\/comments-in-solidity\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"What Are Comments In Solidity and Why It Is Important\" \/>\n<meta property=\"og:description\" content=\"Solidity is one of the most popular entries among programming languages for smart contract development. Many aspiring developers want to learn about the\" \/>\n<meta property=\"og:url\" content=\"https:\/\/101blockchains.com\/comments-in-solidity\/\" \/>\n<meta property=\"og:site_name\" content=\"101 Blockchains\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/101Blockchains\" \/>\n<meta property=\"article:published_time\" content=\"2022-08-05T05:10:56+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-17T05:08:30+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"580\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Georgia Weston\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@101Blockchains\" \/>\n<meta name=\"twitter:site\" content=\"@101Blockchains\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Georgia Weston\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/\"},\"author\":{\"name\":\"Georgia Weston\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#\\\/schema\\\/person\\\/fbc2e4d2ed4f0110630cff03a75bb1f8\"},\"headline\":\"What Are Comments In Solidity and Why It Is Important\",\"datePublished\":\"2022-08-05T05:10:56+00:00\",\"dateModified\":\"2025-03-17T05:08:30+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/\"},\"wordCount\":2139,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/solidity-comments.png\",\"articleSection\":[\"Solidity &amp; Smart Contracts\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/\",\"url\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/\",\"name\":\"What Are Comments In Solidity and Why It Is Important - 101 Blockchains\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/solidity-comments.png\",\"datePublished\":\"2022-08-05T05:10:56+00:00\",\"dateModified\":\"2025-03-17T05:08:30+00:00\",\"description\":\"Solidity is an easy smart contract development programming language with multiple features. Learn more about comments in Solidity and their importance now.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#primaryimage\",\"url\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/solidity-comments.png\",\"contentUrl\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/solidity-comments.png\",\"width\":1200,\"height\":580,\"caption\":\"solidity comments\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/comments-in-solidity\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/101blockchains.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"What Are Comments In Solidity and Why It Is Important\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#website\",\"url\":\"https:\\\/\\\/101blockchains.com\\\/\",\"name\":\"101 Blockchains\",\"description\":\"Your guide to the Blockchain World\",\"publisher\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/101blockchains.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#organization\",\"name\":\"101 Blockchains\",\"url\":\"https:\\\/\\\/101blockchains.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2021\\\/03\\\/image_2021_02_25T10_04_45_211Z.png\",\"contentUrl\":\"https:\\\/\\\/101blockchains.com\\\/wp-content\\\/uploads\\\/2021\\\/03\\\/image_2021_02_25T10_04_45_211Z.png\",\"width\":183,\"height\":175,\"caption\":\"101 Blockchains\"},\"image\":{\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/101Blockchains\",\"https:\\\/\\\/x.com\\\/101Blockchains\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/101blockchains\\\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/101blockchains.com\\\/#\\\/schema\\\/person\\\/fbc2e4d2ed4f0110630cff03a75bb1f8\",\"name\":\"Georgia Weston\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g\",\"caption\":\"Georgia Weston\"},\"description\":\"Georgia Weston is one of the most prolific thinkers in the blockchain space. In the past years, she came up with many clever ideas that brought scalability, anonymity and more features to the open blockchains. She has a keen interest in topics like Blockchain, NFTs, Defis, etc., and is currently working with 101 Blockchains as a content writer and customer relationship specialist.\",\"sameAs\":[\"https:\\\/\\\/101blockchains.com\\\/\",\"https:\\\/\\\/www.linkedin.com\\\/in\\\/georgia-weston\\\/\"],\"url\":\"https:\\\/\\\/101blockchains.com\\\/author\\\/georgiaweston\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"What Are Comments In Solidity and Why It Is Important - 101 Blockchains","description":"Solidity is an easy smart contract development programming language with multiple features. Learn more about comments in Solidity and their importance now.","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:\/\/101blockchains.com\/comments-in-solidity\/","og_locale":"en_US","og_type":"article","og_title":"What Are Comments In Solidity and Why It Is Important","og_description":"Solidity is one of the most popular entries among programming languages for smart contract development. Many aspiring developers want to learn about the","og_url":"https:\/\/101blockchains.com\/comments-in-solidity\/","og_site_name":"101 Blockchains","article_publisher":"https:\/\/www.facebook.com\/101Blockchains","article_published_time":"2022-08-05T05:10:56+00:00","article_modified_time":"2025-03-17T05:08:30+00:00","og_image":[{"width":1200,"height":580,"url":"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png","type":"image\/png"}],"author":"Georgia Weston","twitter_card":"summary_large_image","twitter_creator":"@101Blockchains","twitter_site":"@101Blockchains","twitter_misc":{"Written by":"Georgia Weston","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#article","isPartOf":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/"},"author":{"name":"Georgia Weston","@id":"https:\/\/101blockchains.com\/#\/schema\/person\/fbc2e4d2ed4f0110630cff03a75bb1f8"},"headline":"What Are Comments In Solidity and Why It Is Important","datePublished":"2022-08-05T05:10:56+00:00","dateModified":"2025-03-17T05:08:30+00:00","mainEntityOfPage":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/"},"wordCount":2139,"commentCount":0,"publisher":{"@id":"https:\/\/101blockchains.com\/#organization"},"image":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#primaryimage"},"thumbnailUrl":"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png","articleSection":["Solidity &amp; Smart Contracts"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/101blockchains.com\/comments-in-solidity\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/101blockchains.com\/comments-in-solidity\/","url":"https:\/\/101blockchains.com\/comments-in-solidity\/","name":"What Are Comments In Solidity and Why It Is Important - 101 Blockchains","isPartOf":{"@id":"https:\/\/101blockchains.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#primaryimage"},"image":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#primaryimage"},"thumbnailUrl":"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png","datePublished":"2022-08-05T05:10:56+00:00","dateModified":"2025-03-17T05:08:30+00:00","description":"Solidity is an easy smart contract development programming language with multiple features. Learn more about comments in Solidity and their importance now.","breadcrumb":{"@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/101blockchains.com\/comments-in-solidity\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#primaryimage","url":"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png","contentUrl":"https:\/\/101blockchains.com\/wp-content\/uploads\/2022\/07\/solidity-comments.png","width":1200,"height":580,"caption":"solidity comments"},{"@type":"BreadcrumbList","@id":"https:\/\/101blockchains.com\/comments-in-solidity\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/101blockchains.com\/"},{"@type":"ListItem","position":2,"name":"What Are Comments In Solidity and Why It Is Important"}]},{"@type":"WebSite","@id":"https:\/\/101blockchains.com\/#website","url":"https:\/\/101blockchains.com\/","name":"101 Blockchains","description":"Your guide to the Blockchain World","publisher":{"@id":"https:\/\/101blockchains.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/101blockchains.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/101blockchains.com\/#organization","name":"101 Blockchains","url":"https:\/\/101blockchains.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/101blockchains.com\/#\/schema\/logo\/image\/","url":"https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/03\/image_2021_02_25T10_04_45_211Z.png","contentUrl":"https:\/\/101blockchains.com\/wp-content\/uploads\/2021\/03\/image_2021_02_25T10_04_45_211Z.png","width":183,"height":175,"caption":"101 Blockchains"},"image":{"@id":"https:\/\/101blockchains.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/101Blockchains","https:\/\/x.com\/101Blockchains","https:\/\/www.linkedin.com\/company\/101blockchains\/"]},{"@type":"Person","@id":"https:\/\/101blockchains.com\/#\/schema\/person\/fbc2e4d2ed4f0110630cff03a75bb1f8","name":"Georgia Weston","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d1e6a76103e62f75b3775ecf1f394067f7357215177215fbdd00bc227690e6e0?s=96&d=mm&r=g","caption":"Georgia Weston"},"description":"Georgia Weston is one of the most prolific thinkers in the blockchain space. In the past years, she came up with many clever ideas that brought scalability, anonymity and more features to the open blockchains. She has a keen interest in topics like Blockchain, NFTs, Defis, etc., and is currently working with 101 Blockchains as a content writer and customer relationship specialist.","sameAs":["https:\/\/101blockchains.com\/","https:\/\/www.linkedin.com\/in\/georgia-weston\/"],"url":"https:\/\/101blockchains.com\/author\/georgiaweston\/"}]}},"_links":{"self":[{"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/posts\/35684","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/users\/64"}],"replies":[{"embeddable":true,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/comments?post=35684"}],"version-history":[{"count":11,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/posts\/35684\/revisions"}],"predecessor-version":[{"id":51829,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/posts\/35684\/revisions\/51829"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/media\/35687"}],"wp:attachment":[{"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/media?parent=35684"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/categories?post=35684"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/101blockchains.com\/wp-json\/wp\/v2\/tags?post=35684"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}