Commit Graph

666 Commits

Author SHA1 Message Date
lambdadi 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
Aditya Athalye e28c3a597e Merge pull request #2 from kennethreitz/master
Pulling in the latest changes at origin.
2013-01-30 02:10:57 -08:00
Kenneth Reitz 4d90e839d6 Merge pull request #242 from lambdadi/master
Clarified point about variable names, under Dynamic Typing
2013-01-27 01:47:47 -08:00
Lambda Adi 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
Aditya Athalye 7fa3aa2822 Merge pull request #1 from kennethreitz/master
Pulling in the latest changes.
2013-01-27 01:21:22 -08:00
Kenneth Reitz 04f455b3a3 Merge pull request #240 from dechols/master
Add new Reading section.
2013-01-26 11:45:59 -08:00
David Echols 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
Kenneth Reitz bd7cf677ee Merge pull request #237 from BioGeek/patch-1
Update docs/writing/style.rst
2013-01-25 13:09:17 -08:00
Kenneth Reitz 2fc8d0caab Merge pull request #239 from lihuang/master
fix a simple typo.
2013-01-25 13:09:07 -08:00
Gongzhi 7990eb8e42 fix the typo
nothing more.
2013-01-25 18:07:10 +08:00
Jeroen Van Goey 65c5fb6280 Update docs/writing/style.rst
rpartition() takes a seperator as argument
2013-01-11 10:17:50 +01:00
Kenneth Reitz d3218d431e Update docs/index.rst 2013-01-02 19:09:29 -05:00
Kenneth Reitz 629626a66d Update docs/conf.py 2012-12-31 17:59:47 -05:00
Kenneth Reitz e1b1201b6a Merge pull request #235 from sirMackk/master
Web Scraper Scenario
2012-12-31 14:29:38 -08:00
sirMackk aa7f9aac98 Final version 2012-12-31 17:25:34 -05:00
sirMackk 32dea94b80 Using requests instead of urllib2, final draft. 2012-12-31 17:16:00 -05:00
sirMackk a22a6e92fa Fixing html code-block 2012-12-31 10:39:25 -05:00
sirMackk 83c9cba2a3 Added a bit more code to improve understanding. 2012-12-31 10:37:21 -05:00
sirMackk c3d7bddf3d Third, final markup fixes. 2012-12-31 10:31:08 -05:00
sirMackk 3aef3bd8ef 2nd draft of web scraping scenario
Fixed some markup.
2012-12-31 10:27:29 -05:00
sirMackk faae04c3a3 Added scenario about web scraping using lxml 2012-12-31 10:22:38 -05:00
Kenneth Reitz 2a9c7322a5 Merge pull request #233 from mattstiles/master
Minor change to OSX installation doc
2012-12-27 11:10:08 -08:00
Matt Stiles d0c4e0fa36 Update docs/starting/install/osx.rst
Fixed broken installation command.
2012-12-27 14:07:53 -05:00
Kenneth Reitz 4cac6b5698 Merge pull request #232 from Julian/master
Added Travis for Doctesting (and a few doctests)
2012-12-23 16:12:46 -08:00
Julian Berman ad4819476f Add doctests and switch to using headings. 2012-12-23 18:06:14 -05:00
Julian Berman 90f50c406e Travis CI 2012-12-23 18:06:09 -05:00
Julian Berman 8c80931444 Add doctest ext 2012-12-23 18:05:34 -05:00
Kenneth Reitz 2b82bfcd33 Merge pull request #216 from artiegold/master
Close #193. Notes on virtualenv.
2012-12-21 12:55:26 -08:00
Kenneth Reitz a5a4e58ce1 Merge pull request #218 from suhailvs/patch-1
Update docs/_themes/kr/layout.html
2012-12-21 12:54:39 -08:00
Kenneth Reitz 3a83001855 Merge pull request #223 from Julian/master
Removed a Confusing Example from the Style Article
2012-12-21 12:54:09 -08:00
Kenneth Reitz 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
Kenneth Reitz d8c7b679bd Merge pull request #230 from imrehg/pil
Image Manipulation: add PIL install instructions for Linux
2012-12-15 22:40:54 -08:00
Gergely Imreh 49371fe797 Image Manipulation: add PIL install instructions for Linux
Arch Linux and latest Ubuntu included.
2012-12-16 14:37:07 +08:00
Kenneth Reitz ad5922cd2d Merge pull request #229 from petrushev/add-networking
Added networking section to scenarios.
2012-12-11 04:53:29 -08:00
Baze Petrushev ca5321f0c9 Added networking section to scenarios.
Section includes:
- twisted
- pyzmq (for zeromq)
- gevent (a mention)
2012-12-11 12:47:53 +01:00
Kenneth Reitz 43eaed06c8 Merge pull request #227 from petrushev/add-werkzeug
Added werkzeug entry under web frameworks section
2012-12-10 07:30:09 -08:00
Baze Petrushev 2c22066f14 Added werkzeug entry under web frameworks section 2012-12-10 16:27:49 +01:00
Kenneth Reitz ea12657f10 Merge pull request #226 from MarkyV/master
Fixed some type-os
2012-12-07 14:25:18 -08:00
Mark Veronda be9a256367 Fixed some type-os 2012-12-07 16:55:03 -05:00
Julian Berman 4675c91fc5 Late binding closures 2012-12-04 00:41:43 -05:00
Julian Berman fd9f0db1ce First gotcha. 2012-12-04 00:41:43 -05:00
Julian Berman 0ea7091a30 Removed tuple example from style guide. 2012-12-03 21:56:22 -05:00
Kenneth Reitz a31384a1d7 Merge pull request #220 from sateeshkumarb/patch-1
Update docs/scenarios/scientific.rst
2012-11-26 10:13:50 -08:00
Sateesh 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
Kenneth Reitz b0a1e6a3ad Merge pull request #219 from t-8ch/fix_typos
Fix some typos
2012-11-24 04:47:14 -08:00
Thomas Weißschuh 2210172c50 fix typo in env.rst 2012-11-24 12:41:44 +00:00
Thomas Weißschuh 872bd300fc fix typos in web.rst 2012-11-23 18:45:56 +00:00
suhail 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
Kenneth Reitz fc7fba0edf Merge pull request #217 from alex/patch-8
Remove a paragraph that wasn't adding value
2012-11-19 23:52:00 -08:00
Alex Gaynor 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