Added comment usage suggestion (#25941)

2018-12-21 06:58:03 +01:00 · 2018-12-21 06:58:03 +01:00 · 697c040a66
parent e2daa47404
commit 697c040a66
1 changed files with 2 additions and 0 deletions
--- a/guide/english/ruby/ruby-comments/index.md
+++ b/guide/english/ruby/ruby-comments/index.md
@ -45,3 +45,5 @@ When executed, the program above produces the following:
 ```
 Hello World!
 ```
+
+In general, it's best to use multi-line comments when explaining what your method does or for your program as a whole. Stick to single-line comments when clarifying a line or two of code, but when you find yourself expanding a file just to finish your single-line comment, consider using a multi-line comment instead.