dud: A dub replacement

Steven Schveighoffer schveiguy at gmail.com
Thu Nov 21 14:50:59 UTC 2019


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


More information about the Digitalmars-d-announce mailing list