http://wiki.zynthian.org/index.php?action=history&feed=atom&title=Coding_GuidelinesCoding Guidelines - Revision history2026-11-12T13:07:24ZRevision history for this page on the wikiMediaWiki 1.35.1http://wiki.zynthian.org/index.php?title=Coding_Guidelines&diff=16182&oldid=prevRiban: /* Formatting */2026-11-12T07:55:35Z<p><span dir="auto"><span class="autocomment">Formatting</span></span></p>
<table class="diff diff-contentalign-left diff-editfont-monospace" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 07:55, 12 November 2026</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l123" >Line 123:</td>
<td colspan="2" class="diff-lineno">Line 123:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>No formatter or linter is configured, so format by hand and only on the lines you change. Do not run an auto-formatter over a whole file: it would rewrite thousands of lines and bury your change.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>No formatter or linter is configured, so format by hand and only on the lines you change. Do not run an auto-formatter over a whole file: it would rewrite thousands of lines and bury your change.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* '''Indentation.''' Use 4 spaces, never tabs<del class="diffchange diffchange-inline">. The Python tree has 70,732 space-indented lines against 991 tab-indented lines, all in five files (<code>zynthian''engine''midi''control.py</code>, <code>zynthian''engine''setbfree.py</code>, <code>zynthian''engine''sysex.py</code>, <code>zynthian''ctrldev''mackiecontrol.py</code>, <code>zynthian''gui_arranger.py</code>). When you edit one of those, match the surrounding block. C and C++ use spaces too (12,762 lines against 15)</del>.</div></td><td class='diff-marker'>+</td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* '''Indentation.''' Use 4 spaces, never tabs.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''Line length.''' Nothing is enforced. The median line is 36 characters and the 95th percentile is 86, but 7,927 lines pass 79 and 773 pass 120. Wrap new code at 100 characters.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''Line length.''' Nothing is enforced. The median line is 36 characters and the 95th percentile is 86, but 7,927 lines pass 79 and 773 pass 120. Wrap new code at 100 characters.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''Quotes.''' Double quotes outnumber single quotes roughly two to one. Prefer double quotes for new strings and keep the file's existing style for short dictionary keys.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''Quotes.''' Double quotes outnumber single quotes roughly two to one. Prefer double quotes for new strings and keep the file's existing style for short dictionary keys.</div></td></tr>
<!-- diff cache key zynthian?hwiki:diff::1.12:old-16181:rev-16182 -->
</table>Ribanhttp://wiki.zynthian.org/index.php?title=Coding_Guidelines&diff=16181&oldid=prevRiban: Created page with "= Zynthian UI (tomita branch) Coding Guidelines = == About these guidelines == These guidelines record how code in the <code>tomita</code> branch of zynthian-ui is written t..."2026-11-12T07:13:55Z<p>Created page with "= Zynthian UI (tomita branch) Coding Guidelines = == About these guidelines == These guidelines record how code in the <code>tomita</code> branch of zynthian-ui is written t..."</p>
<a href="http://wiki.zynthian.org/index.php?title=Coding_Guidelines&diff=16181">Show changes</a>Riban