Update documentation.rst

ugurthemaster · ugurthemaster · commit 203b92ce6174 · 2013-11-25T11:05:54.000+02:00
diff --git a/docs/writing/documentation.rst b/docs/writing/documentation.rst
@@ -94,7 +94,9 @@ Reference`_ should help you familiarize yourself with its syntax.
 Code Documentation Advice
 -------------------------
 
-Comments clarify code and begin with a hash (``#``).
+Comments clarify the code and they are added with purpose of making the 
+code easier to understand. In Python, comments begin with a hash 
+(number sign) (``#``).
 
 .. _docstring-ref:
 
