9f5bf3078f
minor typo in reading.rst
2013-03-01 10:59:01 +02:00
528a915e08
minor typos in style.rst
2013-03-01 10:55:48 +02:00
a6f9cc3508
Removing inaccurate statement
...
ctrl-v in vim activates visual block mode. visual block mode can be used to
insert a comment character, but is not itself a comment toggle.
2013-02-03 21:47:03 -05:00
0e989d75f3
Suggest improved introduction to Style/#Idioms
...
My reading, though limited, suggests that the general notion of Idioms
is used often, but rarely explained. It feels very alien to beginners. A
term like "Idiomatic Python" can cause mental stack overflow. It did to
me :) So I humbly submit, in this case, explicit is better than
implicit. I debated whether to place it at the top of the document,
where idioms are first mentioned, but placed it here instead, as this
section explicitly references the topic of idioms.
2013-01-30 18:23:08 +05:30
d00182b541
Clarified point about variable names
...
"Avoid using variables for different things" is misleading at best. The
point must communicate that foolish reuse of _the same_ variable name,
for different types of data, is the hobgoblin of reckless minds :)
2013-01-27 15:04:09 +05:30
7d22f84ff9
Added new Reading section.
...
If readability is so important to python, why don't python guides have a
list of recommended awesome code to read? Why don't they explain that
code? The idea behind this reading section is to provide such a guide.
The idea here is to start with something small and useful, with a vision
for the future, and iterate quickly.
2013-01-26 11:42:42 -08:00
65c5fb6280
Update docs/writing/style.rst
...
rpartition() takes a seperator as argument
2013-01-11 10:17:50 +01:00
ad4819476f
Add doctests and switch to using headings.
2012-12-23 18:06:14 -05:00
3a83001855
Merge pull request #223 from Julian/master
...
Removed a Confusing Example from the Style Article
2012-12-21 12:54:09 -08:00
4248d135f3
Merge pull request #224 from Julian/gotchas
...
Started writing about common gotchas with two quick examples
2012-12-21 12:53:56 -08:00
be9a256367
Fixed some type-os
2012-12-07 16:55:03 -05:00
4675c91fc5
Late binding closures
2012-12-04 00:41:43 -05:00
fd9f0db1ce
First gotcha.
2012-12-04 00:41:43 -05:00
0ea7091a30
Removed tuple example from style guide.
2012-12-03 21:56:22 -05:00
e66b3f1a38
Remove a paragraph that wasn't adding value
...
In addition to be totally wrong about __init__, the description of generators was confusing (and more or less wrong).
2012-11-20 01:51:02 -06:00
53aa1851c4
Merge pull request #205 from hrldcpr/master
...
consistent use of double-underscore for throwaway variable
2012-11-15 17:23:06 -08:00
cefa740985
Merge pull request #207 from andrewmacgregor/master
...
Fixes for warnings in docs
2012-11-15 17:22:15 -08:00
2a7c0912d8
Merge pull request #210 from artiegold/master
...
Fix "it's".
2012-11-15 17:21:27 -08:00
bbfa479227
Fix a tiny typo
2012-11-11 21:04:00 +01:00
ffdde4ac3e
Small text fix. It's "its" not "it's" here.
2012-10-28 15:53:36 -05:00
655c1bdac9
provide valid link for YAGNI
2012-10-16 23:19:54 +08:00
f0834bcfaf
Conventions header was throwing inconsistent level warning. Fixed this and later headings to match rest of page.
2012-10-16 22:21:32 +08:00
f1651e1dc8
looks like a typo, was perhaps meant to be link to decorators but that is only a few lines later
2012-10-16 22:04:15 +08:00
0d4865ed66
use double-underscore for temporary variable, as encouraged elsewhere in this file
2012-10-07 12:41:50 -07:00
852edbee25
Fix typo
2012-10-06 12:49:08 +02:00
b8a41ac61f
build out header matter, clean up formatting
2012-09-22 23:51:59 -04:00
af72128ab9
Merge pull request #197 from mindsocket/master
...
Add mock library to testing page
2012-09-22 18:48:46 -07:00
29af1a2097
tighten, de-dup PEP8 content, improve formatting/organization
2012-09-22 08:19:00 -04:00
3b902fe090
Add examples to section on mock
2012-09-19 16:46:54 +10:00
b96b11fe59
Add mock library to testing page
2012-09-18 21:04:14 +10:00
f2ca4ea7c6
Missing a semicolon in the function definition
2012-09-08 15:23:39 +03:00
dc3af98a38
Merge pull request #183 from thomasballinger/spelling-fix
...
Spelling fixes in style guide
2012-07-28 13:58:20 -07:00
bbb1c2ea19
Revert "Fix spelling in structure.rst"
...
This reverts commit 0ff26166c6
2012-07-08 15:48:56 -04:00
96fb1d42d1
remove slashes in code sample in style guide
2012-07-05 14:55:00 -04:00
a8e36af3ea
fix grammar issues with style guide
2012-07-05 14:47:47 -04:00
0a045fdf78
Fix spelling in style guide
2012-07-05 14:25:25 -04:00
9f792956db
small edit
2012-07-05 01:59:25 -05:00
80a12a70ff
markup fix
2012-07-05 01:57:37 -05:00
4461f0ce8e
Merge pull request #178 from epequeno/modulename
...
Add stub, naming restrictions to structure
2012-07-03 23:33:13 -07:00
1d63c913bf
Fix spelling in writing/tests.rst
2012-07-03 21:56:06 -06:00
e3eac0c78c
Fix spelling in style.rst
2012-07-03 21:55:49 -06:00
0ff26166c6
Fix spelling in structure.rst
2012-07-03 21:48:42 -06:00
28d211f6f5
edit stub
2012-07-03 22:36:07 -05:00
7d66ac6d20
Fix spelling in documentation article
2012-07-03 21:32:00 -06:00
63a2bfc514
Fix awkward wording in "Comments" section
2012-07-03 21:31:10 -06:00
167d566650
add stub
2012-07-03 22:19:31 -05:00
fcefab992c
minor editing
2012-07-03 21:24:08 -05:00
f05bad3839
module naming
2012-07-03 21:08:42 -05:00
810c637f6c
Adding a bit about returning values
2012-06-24 22:31:09 +08:00
513bb5fe51
Adding nested unpacking
2012-06-24 21:47:24 +08:00
barisumog