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
bd7cf677ee
Merge pull request #237 from BioGeek/patch-1
...
Update docs/writing/style.rst
2013-01-25 13:09:17 -08:00
7990eb8e42
fix the typo
...
nothing more.
2013-01-25 18:07:10 +08:00
65c5fb6280
Update docs/writing/style.rst
...
rpartition() takes a seperator as argument
2013-01-11 10:17:50 +01:00
d3218d431e
Update docs/index.rst
2013-01-02 19:09:29 -05:00
629626a66d
Update docs/conf.py
2012-12-31 17:59:47 -05:00
aa7f9aac98
Final version
2012-12-31 17:25:34 -05:00
32dea94b80
Using requests instead of urllib2, final draft.
2012-12-31 17:16:00 -05:00
a22a6e92fa
Fixing html code-block
2012-12-31 10:39:25 -05:00
83c9cba2a3
Added a bit more code to improve understanding.
2012-12-31 10:37:21 -05:00
c3d7bddf3d
Third, final markup fixes.
2012-12-31 10:31:08 -05:00
3aef3bd8ef
2nd draft of web scraping scenario
...
Fixed some markup.
2012-12-31 10:27:29 -05:00
faae04c3a3
Added scenario about web scraping using lxml
2012-12-31 10:22:38 -05:00
d0c4e0fa36
Update docs/starting/install/osx.rst
...
Fixed broken installation command.
2012-12-27 14:07:53 -05:00
ad4819476f
Add doctests and switch to using headings.
2012-12-23 18:06:14 -05:00
8c80931444
Add doctest ext
2012-12-23 18:05:34 -05:00
2b82bfcd33
Merge pull request #216 from artiegold/master
...
Close #193 . Notes on virtualenv.
2012-12-21 12:55:26 -08:00
a5a4e58ce1
Merge pull request #218 from suhailvs/patch-1
...
Update docs/_themes/kr/layout.html
2012-12-21 12:54:39 -08: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
49371fe797
Image Manipulation: add PIL install instructions for Linux
...
Arch Linux and latest Ubuntu included.
2012-12-16 14:37:07 +08:00
ca5321f0c9
Added networking section to scenarios.
...
Section includes:
- twisted
- pyzmq (for zeromq)
- gevent (a mention)
2012-12-11 12:47:53 +01:00
2c22066f14
Added werkzeug entry under web frameworks section
2012-12-10 16:27:49 +01: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
d9d7283106
Update docs/scenarios/scientific.rst
...
A free version of "Enthought Python Distribution" is available.
Modified to indicate the same and remove the statement that
'Enthought is not free'
2012-11-26 23:41:05 +05:30
2210172c50
fix typo in env.rst
2012-11-24 12:41:44 +00:00
872bd300fc
fix typos in web.rst
2012-11-23 18:45:56 +00:00
e85c95b1f7
Update docs/_themes/kr/layout.html
...
Line 27: var ga2 = document.createElement('script');ga.type = 'text/javascript';
i think it is wrongly typed ga.type, so i changed into ga2.type
change
======
ga2.type = 'text/javascript';
2012-11-23 11:43:53 +05:30
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
19db184eb9
Add notes that --no-site-packages is default behavior for virtualenv
...
from version 1.7 onward. Close #193 .
2012-11-15 23:13:58 -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
b55af5cbcf
Merge pull request #214 from pengkui/master
...
added some comments on .vimrc for vim beginners
2012-11-15 17:22:39 -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
6a65c031ae
Merge pull request #211 from Kwpolska/patch-1
...
Fix a tiny typo
2012-11-15 17:21:13 -08:00
64934821c4
Update docs/dev/env.rst
...
.vimrc file: added 'autoindent'; added comments to illustrate.
2012-11-14 04:48:21 -06:00
8d90429813
Update docs/starting/which-python.rst
2012-11-14 04:02:58 -06:00
d7704e4808
Update link to latest windows python version
2012-11-12 04:28:38 +02: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
6da56aff38
Info about the Salt stack
2012-10-23 20:34:30 +03:00
1336375ab4
Merge remote-tracking branch 'upstream/master'
...
Conflicts:
docs/conf.py
2012-10-20 09:17:18 +08:00
d13792a3a2
death to curly quotes!
2012-10-17 09:21:40 -07: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
lambdadi