No comments. Now what?

1

Quarto

Another effective way to use comments is through literate programming. In this programming style, comments take the spotlight: the source code contains more prose than executable code. This is useful when explaining the algorithm is more important than reading it, as in academic research and data analysis. Not surprisingly, it is the paradigm of popular tools like Jupyter Notebook and Quarto.

#Configuration Management #Text Editors #Mobile Apps 20 social mentions

2

Liferay Digital Experience Platform

Traditionally, it is considered good practice to comment code. However, this wisdom has been revisited in recent times. At Liferay, for example, we follow a policy of not commenting code. Personally, I am an enthusiast of this philosophy. But I don't want to present or defend this strategy here, there is a lot of good material on this subject. I want to discuss an open question.

#CMS #Blogging Platform #Blogging 2 social mentions

3

Jupyter

Another effective way to use comments is through literate programming. In this programming style, comments take the spotlight: the source code contains more prose than executable code. This is useful when explaining the algorithm is more important than reading it, as in academic research and data analysis. Not surprisingly, it is the paradigm of popular tools like Jupyter Notebook and Quarto.

#Data Science And Machine Learning #Data Science Tools #Data Science Notebooks 205 social mentions

4

JSDoc

Even more relevant, tools like Javadoc, JSDoc, Doxygen, etc. Read comments in a specific format to generate documentation. These comments do not affect readability. On the contrary, Javadocs are great for explaining how to use these entities. Combined with tools like my dear Doctest, we even get guarantees of accuracy and correctness!

#Documentation #Documentation As A Service & Tools #Developer Tools 48 social mentions