Any programmer that doesn't include comments or that tries to make his code hard to read should be fired or at least put in management.
Any programmer that doesn't include comments or that tries to make his code hard to read should be fired or at least put in management.
Unless, that is, the obfuscation is an expected part of the job, an effort to stymie reverse engineering and thus slow down the dispersion of trade secrets (and the cloning of patented processes without authorization.)
And the compiler can take care of that. If your code does not include comments and explanations then you did a disservice to those supporting the application. If you understood this you could still make code that is hard to reverse engineer but still easy to maintain for those following you.
Very little comments are kept in source code anymore. The comments are kept in other types of documents separate from the code and is maintained. It's called documentation artifacts.
It doesn't matter where you keep them as long as they are updated as needed when making changes to the source. If you don't have comments/descriptions, as I said before, you are doing a disservice to all the people that support/follow you.
Cabling-Design.com Forums website is not affiliated with any of the manufacturers or service providers discussed here. All logos and trade names are the property of their respective owners.