diff --git a/guide/english/java/comments-in-java/index.md b/guide/english/java/comments-in-java/index.md index 9747b7591c..9a33607790 100644 --- a/guide/english/java/comments-in-java/index.md +++ b/guide/english/java/comments-in-java/index.md @@ -5,7 +5,7 @@ title: Comments in Java Comments in Java are like real life sticky notes used to display some helpful information, which other programmers or developers can read and understand. Because they are intended for humans, Java comments are not executed by the compiler or interpreter. -It is a good practice to add meaningful comments to your code, especially when working with a team or at a company. This helps future developers or teammates to know what is going on more easily when they look at your code. Comments make your code more neat and organized. +It is considered good practice to add comments to your code, especially when working with a team. This helps future developers and teammates to more easily understand your code. Comments make your code more neat and organized. Note above the phrase **meaningful** comments. As a general rule, good code should be readable without execessive comments. Another programmer should be able to review your code and understand *what* has happened, but good comments can help explain *why*. Comments should also be updated as code changes over time. In short, all comments in Java should be meaningful, relevant, and current.