Update 'Coding Style'
parent
17cf62ab5b
commit
28a4fd80ff
1 changed files with 9 additions and 1 deletions
|
@ -27,3 +27,11 @@ This document discusses practices and style for programmers working on the BigWh
|
||||||
- [Names](#names)
|
- [Names](#names)
|
||||||
|
|
||||||
## The Single Most Important Rule
|
## The Single Most Important Rule
|
||||||
|
Above all, the following rule from the GNOME developer documentation should always be followed.
|
||||||
|
>The single most important rule when writing code is this: check the surrounding code and try to imitate it.
|
||||||
|
>
|
||||||
|
>As a maintainer it is dismaying to receive a patch that is obviously in a different coding style to the surrounding code. This is >disrespectful, like someone tromping into a spotlessly-clean house with muddy shoes.
|
||||||
|
>
|
||||||
|
>So, whatever this document recommends, if there is already written code and you are contributing to it, keep its current style >consistent even if it is not your favorite style.
|
||||||
|
>
|
||||||
|
>Most importantly, do not make your first contribution to a project a change in the coding style to suit your taste. That is >incredibly disrespectful.
|
Loading…
Reference in a new issue