diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst index b8e31c4..c3c0a22 100644 --- 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 `_ + +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 `_ diff --git a/docs/scenarios/cli.rst b/docs/scenarios/cli.rst index 546eae0..933b0f0 100644 --- a/docs/scenarios/cli.rst +++ b/docs/scenarios/cli.rst @@ -6,11 +6,14 @@ Command Line Applications Clint ----- -.. todo:: Write about Clint +`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 `_ is a lightweight, highly Pythonic package that allows creating command line interfaces easily and intuitively, by parsing -POSIX-style usage instructions. \ No newline at end of file +POSIX-style usage instructions. diff --git a/docs/writing/documentation.rst b/docs/writing/documentation.rst index d543f53..7793af4 100644 --- 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: