Skip to content

Commit 404c258

Browse files
committed
More grammar and cross reference for realpython#132.
1 parent 951f210 commit 404c258

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

docs/writing/structure.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -161,11 +161,11 @@ only advantage over a simpler ``import modu`` is that it will save a little typi
161161
[...]
162162
x = modu.sqrt(4) # sqrt is visibly part of modu's namespace
163163
164-
As said in the section about style, readability is one of the main features of
165-
Python. Readability means to avoid useless boilerplate text and clutter,
166-
therefore some efforts are spent trying to achieve a certain level of brevity.
167-
But terseness and obscurity are the limits where brevity should stop. Being
168-
able to tell immediately where a class or function comes from, as in the
164+
As mentioned in the :ref:`code_style` section, readability is one of the main
165+
features of Python. Readability means to avoid useless boilerplate text and
166+
clutter, therefore some efforts are spent trying to achieve a certain level of
167+
brevity. But terseness and obscurity are the limits where brevity should stop.
168+
Being able to tell immediately where a class or function comes from, as in the
169169
``modu.func`` idiom, greatly improves code readability and understandability in
170170
all but the simplest single file projects.
171171

0 commit comments

Comments
 (0)