On 11/20/19 6:40 AM, Robert Schadek wrote:
* for the same reasons, really try to provide good documentation and
comments
for all code from the start -- this really makes it much easier
for anyone
interested to grasp the major design concerns and get contributing
Here is disagree, to a degree I consider comments a code smell.
If I have to write them, I failed to convey the information
needed to understand the code in the code.
Assuming the code you wrote does what you wanted it to do...
Often times, comments convey what you're thinking, and it's much easier
to understand a description than mentally compiling and running the code
to figure out what you were thinking.
-Steve
