comparison doc/v2_planning/coding_style.txt @ 1025:1c96e7ad95c3

coding_style: Added discussion point about backward compatibility with Python 2.x versions
author Olivier Delalleau <delallea@iro>
date Fri, 03 Sep 2010 16:58:25 -0400
parents e21b3fdec4ef
children c6a74b24330b
comparison
equal deleted inserted replaced
1024:f3801e0e3913 1025:1c96e7ad95c3
6 - Dumitru 6 - Dumitru
7 - Fred 7 - Fred
8 - David 8 - David
9 - Olivier D [leader unless David wants to be] 9 - Olivier D [leader unless David wants to be]
10 10
11 Existing Python coding style specifications and guidelines: 11 Existing Python coding style specifications and guidelines
12 ----------------------------------------------------------- 12 ----------------------------------------------------------
13 13
14 * http://www.python.org/dev/peps/pep-0008/ 14 * http://www.python.org/dev/peps/pep-0008/
15 * http://google-styleguide.googlecode.com/svn/trunk/pyguide.html 15 * http://google-styleguide.googlecode.com/svn/trunk/pyguide.html
16 * http://www.voidspace.org.uk/python/articles/python_style_guide.shtml 16 * http://www.voidspace.org.uk/python/articles/python_style_guide.shtml
17 * http://python.net/~goodger/projects/pycon/2007/idiomatic/handout.html 17 * http://python.net/~goodger/projects/pycon/2007/idiomatic/handout.html
26 * http://docs.djangoproject.com/en/dev/internals/contributing/#coding-style 26 * http://docs.djangoproject.com/en/dev/internals/contributing/#coding-style
27 27
28 We will probably want to take PEP-8 as starting point, and read what other 28 We will probably want to take PEP-8 as starting point, and read what other
29 people think about it / how other coding guidelines differ from it. 29 people think about it / how other coding guidelines differ from it.
30 30
31 Documentation: 31 Documentation
32 -------------- 32 -------------
33 33
34 How do we write doc? 34 How do we write doc?
35 35
36 Python 3: 36 Compatibility with various Python versions
37 --------- 37 ------------------------------------------
38 38
39 Is it reasonable to have coding guidelines that would make the code as 39 * Which Python 2.x version do we want to support?
40
41 * Is it reasonable to have coding guidelines that would make the code as
40 compatible as possible with Python 3? 42 compatible as possible with Python 3?
41 43
42 44 C coding style
43 C coding style: 45 --------------
44 ---------------
45 46
46 We also need a c-style coding style. 47 We also need a c-style coding style.