375 Commits

Author SHA1 Message Date
Duta 18c3e05e26 Minor wording correction and changed some code-block tags to be python 2013-08-12 13:31:18 +01:00
Duta c666597a73 Update style.rst 2013-08-12 12:44:37 +01:00
claudejrogers 51a727d079 Update "Late Binding Closures" section of gotchas.rst
The late binding closure example seems like a good use case for the
functools.partial function.
2013-08-11 20:35:30 -07:00
kuyan 13d99d95fe Let Sphinx link to Python documentation.
Instead of directly linking to the relevant passages.
2013-08-03 19:28:48 -07:00
kuyan 88fccb1b4d Use code tags where needed. 2013-08-03 19:19:59 -07:00
kuyan 0fd1b7a9ab Use code tags where needed. 2013-08-03 19:12:18 -07:00
kuyan 9072b68de4 more code tags. 2013-07-30 13:39:51 -07:00
kuyan 6753406a40 Declare code block language, fix formatting 2013-07-30 13:19:31 -07:00
kuyan 1a77f1bbec No need to say 'PEP 8' twice. 2013-07-30 13:13:05 -07:00
kuyan d95b26b4e7 Use code tags where needed. 2013-07-30 13:10:46 -07:00
kuyan b6f014342d Use the :pep: tag instead of directly linking PEPs 2013-07-30 13:05:56 -07:00
Matthew Boehm 963ab0aabf Fix enumerate code snippet to run without error message
Code previously added numbers to strings, which results in a TypeError
2013-07-28 10:20:47 -04:00
Roland van Laar 93cb68e308 Fix link to tox documentation. 2013-07-20 09:08:59 +02:00
Kenneth Reitz 12a9eeeca0 Merge pull request #284 from kuyan/master
Grammar, capitalization fixes
2013-07-15 06:27:29 -07:00
Arthur Loder 8d6f737438 minor formatting changes. 2013-06-21 22:35:10 -04:00
Gerald Rich 3b6a7ca913 copy edit structure.rst 2013-06-13 02:25:37 -04:00
kuyan 598c5695b7 Correct spelling of 'aforementioned'. 2013-06-12 19:39:32 -07:00
Dominique Plante b4a08152b7 reapply some improvements to code style section in different branch 2013-05-13 21:37:51 -07:00
Kenneth Reitz fee9fcd990 Merge pull request #261 from ozgur/string_concatenation_note
Note added on string concatenation
2013-04-13 20:24:54 -07:00
Kenneth Reitz 08b8eec134 Merge pull request #265 from simon-weber/gotcha_fixes
Fix naming and confusing example in gotchas
2013-04-13 20:24:35 -07:00
Simon Weber e1b5968857 close #241 2013-04-03 23:24:02 -04:00
Simon Weber aa25ef5996 merge upstream 2013-04-03 16:48:52 -04:00
Simon Weber 5da8f3e0e6 gotchas: fix naming; remove generator in def example 2013-04-03 16:42:36 -04:00
Kenneth Reitz c7f1da22a2 Merge pull request #264 from simon-weber/fix-codestyle-typo
Fix typo/links to code_style section
2013-04-03 09:50:02 -07:00
Simon Weber 7cf628d8ea fix links to code_style section 2013-04-03 12:46:48 -04:00
Pascal Borreli 54f1d8ca4d Fixed typos 2013-04-01 19:09:15 +00:00
Özgür Vatansever 328df72c4f code block newline added 2013-03-31 22:19:16 +03:00
Özgür Vatansever 425d6155e0 note added on string concatenation 2013-03-31 18:23:42 +03:00
Kyle Kelley 7a1077a464 dos2unix for writing/structure 2013-03-23 00:07:12 -04:00
Kyle Kelley 8e9a21e17e Bye bye dos newlines 2013-03-23 00:04:43 -04:00
Kyle Kelley 810956c56b Grammar: plurality fixes, tense fix, typos 2013-03-18 19:06:50 -03:00
Kyle Kelley bc7799d1fa Separate join and list comprehension 2013-03-18 18:48:45 -03:00
Kyle Kelley b9b50213bb Quick grammar fix 2013-03-18 18:46:08 -03:00
Kyle Kelley 1fb50a3999 Made more direct and concise
The guide is opinionated, and that's ok.
2013-03-18 18:30:05 -03:00
Eli 709f8d3451 Fix mispelling 2013-03-08 16:55:48 -05:00
Kenneth Reitz b3146b58cc Merge pull request #244 from mkomitee/master
ctrl-v is not a comment toggle in vim
2013-03-06 09:47:56 -08:00
lambdadi 8c15d01979 Fix markdown formatting mistakes
Markdown formatting, for text emphasis and file paths, was broken in my
previous commit to the 'Idioms' section of the style.rst document. My
previous commit may be found at:
https://github.com/kennethreitz/python-guide/pull/243

Sorry!
2013-03-06 14:38:23 +05:30
Kenneth Reitz 9178fdfd2c Merge pull request #243 from lambdadi/master
Suggest improved introduction to Style/#Idioms
2013-03-04 15:41:21 -08:00
Kenneth Reitz d950093e81 Merge pull request #249 from barisumog/master
minor typos and omitted words
2013-03-04 15:39:49 -08:00
gurpinars 3ac59eb08c modified structure.rst 2013-03-04 22:17:09 +02:00
gurpinars 6a5341cfce added further reading in structure.rst 2013-03-04 22:10:22 +02:00
barisumog a0761200eb minor typo 2013-03-01 11:15:55 +02:00
barisumog f7c306e206 minor typos 2013-03-01 11:13:33 +02:00
barisumog df402a1c8e minor typo in documentation.rst 2013-03-01 11:04:24 +02:00
barisumog 9f5bf3078f minor typo in reading.rst 2013-03-01 10:59:01 +02:00
barisumog 528a915e08 minor typos in style.rst 2013-03-01 10:55:48 +02:00
Michael Komitee 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
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
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
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