Merge pull request realpython#340 from ugurthemaster/master

kennethreitz · kennethreitz · commit 8e00707d8298 · 2014-01-08T11:26:27.000-08:00
Update learning.rst
diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst
@@ -169,3 +169,12 @@ This is Python's reference manual, it covers the syntax and the core semantics o
 language.
 
     `The Python Language Reference <http://docs.python.org/reference/index.html>`_
+    
+Python Pocket Reference
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Python Pocket Reference, written by Mark Lutz, is an easy to use reference to the
+core language, with descriptions of commonly used modules and toolkits. It covers
+Python 3 and 2.6 versions.
+
+    `Python Pocket Reference <http://shop.oreilly.com/product/9780596158095.do>`_
diff --git a/docs/scenarios/cli.rst b/docs/scenarios/cli.rst
@@ -6,11 +6,14 @@ Command Line Applications
 Clint
 -----
 
-.. todo:: Write about Clint
+`clint <https://pypi.python.org/pypi/clint/>`_ is a python module which is 
+filled with very useful tools for developing commandline applications.
+It supports features such as; CLI Colors and Indents, Simple and Powerful
+Column Printer, Iterator based progress bar and Implicit argument handling.
 
 docopt
 ------
 
 `docopt <http://docopt.org/>`_ is a lightweight, highly Pythonic package that
 allows creating command line interfaces easily and intuitively, by parsing
-POSIX-style usage instructions.
+POSIX-style usage instructions.
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:
 
