doc: BasicScripting: method names should be inlined
Bug #435159 reported by
NicDumZ
This bug affects 1 person
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Zope 2 |
Fix Released
|
Undecided
|
Tres Seaver |
Bug Description
reST extract:
"""
returning it manually, rather than relying on the::
statement.
"""
It would be better to write this as:
"""
returning it manually, rather than relying on the ``print`` statement.
"""
for readability. This happens several times. Later on, we have:
"""
to check if::
foo
is a list
"""
And the terribly hard to read:
"""
Note that::
context.
works because there is no dot in the id of the template. In Python, dots are
used to separate ids. This is the reason why Zope often uses ids like::
index_html
instead of the more common::
index.html
and why this example uses::
hello_world_pt
instead of::
hello_world.pt
"""
and so on...
To post a comment you must log in.
And here's a patch.