kennethreitz/python-guide
1
0
Fork 0
mirror of https://github.com/kennethreitz/python-guide.git synced 2026-06-05 23:00:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

More grammar and cross reference for #132.

Browse Source
This commit is contained in:
george
2014-06-17 11:07:49 -06:00
parent 951f210d02
commit 404c2581ee
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/writing/structure.rst
+5 -5
View File
@@ -161,11 +161,11 @@ only advantage over a simpler ``import modu`` is that it will save a little typi
[...] [...]
x = modu.sqrt(4) # sqrt is visibly part of modu's namespace x = modu.sqrt(4) # sqrt is visibly part of modu's namespace
As said in the section about style, readability is one of the main features of As mentioned in the :ref:`code_style` section, readability is one of the main
Python. Readability means to avoid useless boilerplate text and clutter, features of Python. Readability means to avoid useless boilerplate text and
therefore some efforts are spent trying to achieve a certain level of brevity. clutter, therefore some efforts are spent trying to achieve a certain level of
But terseness and obscurity are the limits where brevity should stop. Being brevity. But terseness and obscurity are the limits where brevity should stop.
able to tell immediately where a class or function comes from, as in the Being able to tell immediately where a class or function comes from, as in the
``modu.func`` idiom, greatly improves code readability and understandability in ``modu.func`` idiom, greatly improves code readability and understandability in
all but the simplest single file projects. all but the simplest single file projects.