diff --git a/guide/english/documentation/index.md b/guide/english/documentation/index.md index b831a9db4a..5aef954385 100644 --- a/guide/english/documentation/index.md +++ b/guide/english/documentation/index.md @@ -9,6 +9,8 @@ For example, if you happen to pass along your code to an absolute beginner, they It may become an extremely important idea to make a habit out of commenting your functions, loops, and declarations and treating comments as part of the source code, just as regular code should be. +Many developers have probably learned that it is much harder to go back through your code and comment it after you finish. It's always a good idea to label and comment your code as you go, so that you don't forget or mix up what certain variables or functions do. + ![An example of commenting in the real world](https://cdn-images-1.medium.com/max/1620/1*Pyxsc7Uixbitv5myywaA_Q.jpeg)