Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Delta Between Two Patch Sets: pages/coding-style.html

Issue 29340492: Issue 3950 - Extend the Python coding practices (Closed)
Left Patch Set: Created April 18, 2016, 11:17 a.m.
Right Patch Set: Improved texts as discussed with Vasily Created April 18, 2016, 12:17 p.m.
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
Left: Side by side diff | Download
Right: Side by side diff | Download
« no previous file with change/comment | « no previous file | no next file » | no next file with change/comment »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
LEFTRIGHT
1 title=Coding Style 1 title=Coding Style
2 2
3 3
4 <h2 id="precedence">{{s1 Precedence}}</h2> 4 <h2 id="precedence">{{s1 Precedence}}</h2>
5 5
6 <p>{{s2 The Adblock Plus coding style is based on others. Our rules (both genera l and language specific) always overrule referenced style guides. The language s pecific sections overrule the general section.}}</p> 6 <p>{{s2 The Adblock Plus coding style is based on others. Our rules (both genera l and language specific) always overrule referenced style guides. The language s pecific sections overrule the general section.}}</p>
7 7
8 <h2 id="consistency">{{s3 Consistency}}</h2> 8 <h2 id="consistency">{{s3 Consistency}}</h2>
9 9
10 <p>{{s4 Consistency is most important: Be consistent within functions, files, mo dules and projects. Making existing code conform with this style guide is fine, but it should happen in dedicated commits, preferably for a whole module or proj ect at once.}}</p> 10 <p>{{s4 Consistency is most important: Be consistent within functions, files, mo dules and projects. Making existing code conform with this style guide is fine, but it should happen in dedicated commits, preferably for a whole module or proj ect at once.}}</p>
(...skipping 27 matching lines...) Expand all
38 <li>{{html-css-shorthand CSS shorthand properties usage is optional.}}</li> 38 <li>{{html-css-shorthand CSS shorthand properties usage is optional.}}</li>
39 <li>{{html-css-order CSS rule declaration order should follow the <a href="htt ps://make.wordpress.org/core/handbook/best-practices/coding-standards/css/#prope rty-ordering">WordPress CSS Coding Standards</a>.}}</li> 39 <li>{{html-css-order CSS rule declaration order should follow the <a href="htt ps://make.wordpress.org/core/handbook/best-practices/coding-standards/css/#prope rty-ordering">WordPress CSS Coding Standards</a>.}}</li>
40 <li>{{html-css-units CSS number values should specify units where possible.}}< /li> 40 <li>{{html-css-units CSS number values should specify units where possible.}}< /li>
41 <li>{{html-css-leading-zero Don't omit the optional leading 0 for decimal numb ers.}}</li> 41 <li>{{html-css-leading-zero Don't omit the optional leading 0 for decimal numb ers.}}</li>
42 </ul> 42 </ul>
43 43
44 <h2 id="python">{{s19 Python}}</h2> 44 <h2 id="python">{{s19 Python}}</h2>
45 <ul> 45 <ul>
46 <li>{{python-general Follow <a href="https://www.python.org/dev/peps/pep-0008/ ">PEP-8</a> and the Mozilla Coding Style's <a href="https://developer.mozilla.or g/en-US/docs/Developer_Guide/Coding_Style#Python_Practices">Python practices</a> .}}</li> 46 <li>{{python-general Follow <a href="https://www.python.org/dev/peps/pep-0008/ ">PEP-8</a> and the Mozilla Coding Style's <a href="https://developer.mozilla.or g/en-US/docs/Developer_Guide/Coding_Style#Python_Practices">Python practices</a> .}}</li>
47 <li>{{python-prefix In modules, prefix private functions and variables with a single underscore.}}</li> 47 <li>{{python-prefix In modules, prefix private functions and variables with a single underscore.}}</li>
48 <li>{{python-concatenation Use the <code><fix>+</fix></code> operator when con catenating exactly two string, use the <a href="https://docs.python.org/2/librar y/stdtypes.html#str.format"><code><fix>format()</fix></code> method</a> when con catenating more strings.}}</li> 48 <li>{{python-concatenation Use the <code><fix>+</fix></code> operator when con catenating exactly two strings, use the <a href="https://docs.python.org/2/libra ry/stdtypes.html#str.format"><code><fix>format()</fix></code> method</a> for mor e complex string formatting, use the <a href="https://docs.python.org/2/library/ stdtypes.html#str.join"><code><fix>join()</fix></code> method</a> when concatena ting pre-existing sequences.}}</li>
49 <li>{{python-tuple-vs-list Use tuples for data that have structure, use lists for data that have order.}}</li> 49 <li>{{python-tuple-vs-list Use tuples for data that have structure, use lists for data that have order.}}</li>
50 </ul> 50 </ul>
51 51
52 <h2 id="java">{{s22 Java}}</h2> 52 <h2 id="java">{{s22 Java}}</h2>
53 <ul> 53 <ul>
54 <li>{{s23 Follow the Mozilla Coding Style's <a href="https://developer.mozilla .org/en-US/docs/Developer_Guide/Coding_Style#Java_practices">Java practices</a>. }}</li> 54 <li>{{s23 Follow the Mozilla Coding Style's <a href="https://developer.mozilla .org/en-US/docs/Developer_Guide/Coding_Style#Java_practices">Java practices</a>. }}</li>
55 <li>{{s24 Imports should be organised consistently per file, we don't use glob al rules.}}</li> 55 <li>{{s24 Imports should be organised consistently per file, we don't use glob al rules.}}</li>
56 </ul> 56 </ul>
57 57
58 <h2 id="cpp">{{s25 C++}}</h2> 58 <h2 id="cpp">{{s25 C++}}</h2>
59 <ul> 59 <ul>
60 <li>{{s26 Follow the Mozilla Coding Style's <a href="https://developer.mozilla .org/en-US/docs/Developer_Guide/Coding_Style#C.2FC.2B.2B_practices">C++ practice s</a>.}}</li> 60 <li>{{s26 Follow the Mozilla Coding Style's <a href="https://developer.mozilla .org/en-US/docs/Developer_Guide/Coding_Style#C.2FC.2B.2B_practices">C++ practice s</a>.}}</li>
61 <li>{{s27 Indent namespace bodies.}}</li> 61 <li>{{s27 Indent namespace bodies.}}</li>
62 <li>{{s28 Avoid manual memory management: Use references and values when possi ble, smart pointers when necessary, raw pointers only for weak references.}}</li > 62 <li>{{s28 Avoid manual memory management: Use references and values when possi ble, smart pointers when necessary, raw pointers only for weak references.}}</li >
63 <li>{{s29 Don't use C-style casts unless its exact semantics are required.}}</ li> 63 <li>{{s29 Don't use C-style casts unless its exact semantics are required.}}</ li>
64 <li>{{s30 We tend to use anonymous namespaces instead of static.}}</li> 64 <li>{{s30 We tend to use anonymous namespaces instead of static.}}</li>
65 </ul> 65 </ul>
66 66
67 <h2 id="objc">{{objective-c Objective-C}}</h2> 67 <h2 id="objc">{{objective-c Objective-C}}</h2>
68 <ul> 68 <ul>
69 <li>{{objc-conventions Follow Apple's <a href="https://developer.apple.com/lib rary/ios/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Conventions/Co nventions.html">conventions</a>}}.</li> 69 <li>{{objc-conventions Follow Apple's <a href="https://developer.apple.com/lib rary/ios/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Conventions/Co nventions.html">conventions</a>}}.</li>
70 </ul> 70 </ul>
71 71
72 <h2 id="puppet">{{s31 Puppet}}</h2> 72 <h2 id="puppet">{{s31 Puppet}}</h2>
73 <ul> 73 <ul>
74 <li>{{s32 Follow the <a href="http://docs.puppetlabs.com/guides/style_guide.ht ml">Puppet Style Guide</a>.}}</li> 74 <li>{{s32 Follow the <a href="http://docs.puppetlabs.com/guides/style_guide.ht ml">Puppet Style Guide</a>.}}</li>
75 <li>{{s33 Opening braces don't go on their own line.}}</li> 75 <li>{{s33 Opening braces don't go on their own line.}}</li>
76 <li>{{s34 Arrows should not be aligned.}}</li> 76 <li>{{s34 Arrows should not be aligned.}}</li>
77 </ul> 77 </ul>
LEFTRIGHT
« no previous file | no next file » | Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Toggle Comments ('s')

Powered by Google App Engine
This is Rietveld