Geeks With Blogs

News Ashraful Alam Joy

Create Your Badge

Ashraful Alam is a Software Architect, who has 8 years of professional experience in Software Development industry. This Bangladeshi national is involved with project management and development of several US based software projects from his country. Already he has managed and developed several software projects, which are being used by several users of different countries, such as USA, Canada, Australia, and Bangladesh. While developing and managing a team, he contains and maintains a set of well defined engineering practices developed by him and other online developer communities.

Due to his willingness to give effort to improve and share better software development practices, Ashraf has been awarded as “Most Valuable Professional” (MVP) in ASP.NET category by Microsoft since year 2007 multiple times, which is a rare honor and prestigious reorganization among the developers around the world.

Check his portfolio to know more about him and his works.

.NETTER Characters... Every part of your life is best, if you can know yourself and thus create your life like an artist!


Before going to consider whether comments are really needed, let’s consider few other things that already became “rivals” of it.

  • Unit Tests: Having well written unit tests are smarter and useful solution, than detailed comments. Unit tests not only can check for the quality (and better architectural design in case of TDD), but also serves as a documentation regarding how the API should be used.
  • Advanced IDE Features: With the advanced features, such as conditional debugging, call stack, dependency graph (and a lot more) in modern IDE’s its relatively easy to understand the code without manually reading the comment and the code.
  • Architectural Documentation: A well written architectural documentation really helps people who intend to start working on an existing codebase.

Now the first question, whether comments are needed? The short answer is, yes. However in real world comment may lead to confusions if they are not maintained through the change cycle of the code. Thus it should be written only when it is really needed and should be maintained.
And the next question is why good developers don’t want to write comment? I’d say, people who build software that meet quality, time and budget accordingly are good developers, where almost everyone uses the “rivals” of comments, along with bare minimum comments (that are truly required), some of them are more obsessed to focus on unit tests, as these are automated and easy to maintain than comments.

Posted on Friday, May 31, 2013 9:55 PM | Back to top

Comments on this post: Pop Quiz: Why Don't Good Developers Want to Write Comments?

No comments posted yet.
Your comment:
 (will show your gravatar)

Copyright © Ashraf Alam | Powered by: