title: Java code commenting best practices
body: <p>I have finalized my Java/Android project and now I need to comment the codes (mainly classes and important methods).</p>
  
  <p>I need to do it by following the best industrial standards as later if someone else need to modify, it should be well staright forward.</p>
  
  <p>I read many articles and found 3 main types of java commenting styles.</p>
  
  <ol>
  <li>Single line comment (//.....)</li>
  <li>Block comments (/* ....... */)</li>
  <li>Doc comments (/** ....... */)</li>
  </ol>
  
  <p>I read mainly about the option 2 and 3. <a href="https://stackoverflow.com/questions/3607641/javadoc-comments-vs-block-comments">Stack overflow discussions</a></p>
  
  <p>So I thought of going with 2nd option as I don't need to generate HTML docs as these classes are not going to use by any other people and this is the implementation of this app.</p>
  
  <p>Wonder what are the best practices in block commenting indicating "return" type, "parameters" and "breif description" of the method or class.</p>
  
  <p>Would like to hear the best industrial standard practices of the java code commenting. </p>
  
  <p>Thanks in advance...!!!</p>