diff --git a/guide/english/java/comments-in-java/index.md b/guide/english/java/comments-in-java/index.md
index 2dac9abad4c..664fba29fce 100644
--- a/guide/english/java/comments-in-java/index.md
+++ b/guide/english/java/comments-in-java/index.md
@@ -43,7 +43,9 @@ public class MyFirstJava {
 #### 3. Documentation Comments
 
 
-Documentation comments are used by the Javadoc tool to create documentation for the code. Documentation comments are used by developers to document code, such as explaining what a class or method does. These comments are parsed by a Javadoc tool, which will compile a preformatted set of HTML files containing all the information available in the comments. The output typically is HTML files created for your code which are more readable and can be shared as well.
+Documentation comments are used by the Javadoc tool to create documentation for the code. Documentation comments are used by developers to document code, such as explaining what a class or method does. These comments are parsed by a Javadoc tool, which will compile a preformatted set of HTML files containing all the information available in the comments. The output typically is HTML files created for your code which are more readable and can be shared as well. 
+
+It's always a good practice to write the javadoc before actually writing the function or method block of code. It helps in focusing on the purpose of method/class and creating modular code.
 
 ```java
 /**