@@ -16,7 +16,7 @@ years. This is because not every developer:
1616
1717- is aware that code is generally read 10 times more than it is changed.
1818- is aware of the potential pitfalls in one programming language, which are
19- a good way in other .
19+ a good way in others .
2020- is aware of the impact of using (or neglecting to use) particular solutions
2121 on aspects like security, performance, multi-language support, etc.
2222- realizes that not every developer is as capable, skilled or experienced to
@@ -29,7 +29,7 @@ something is not explicitly listed as bad, it does not mean that using it is
2929okay.
3030
3131There is a set of rules than can be applied to all situations, regardless of
32- their context. The include the following:
32+ their context. These include the following:
3333
3434- [ Principle of least astonishment (a.k.a. POLA)] [ pola ] : you should choose
3535 solution that everyone can understand, and that keeps them on the right track.
@@ -53,16 +53,16 @@ ordinary developer, exposes unusual behavior, or tries to solve many possible
5353future issues, it es very likely the wrong solution and needs redesign. The
5454worst response a developer can give yo to these principles is: "But it works!".
5555
56- ## Wie fange ich an ?
56+ ## How do you get started ?
5757- Ask all developers to carefully read this document at least once. This will
58- give them a sense of the kind of guidelines the document containes .
59- - Make sure evereybody agrees with the rules.
58+ give them a sense of the kind of guidelines the document contains .
59+ - Make sure everybody agrees with the rules.
6060- Create a [ project checklist] [ project-checklist ] with the most important rules
6161 and use this checklist for your [ Peer Review] [ peer-review ] .
6262- Consider forking the original source and create your own internal version of
6363 the document.
64- - Use tools, e. g. IDEs, compiler plugins or build tools, to be able to comply
65- with these guidelines. THe most IDEs have a intelligent code instpection
64+ - Use tools, e.g. IDEs, compiler plugins or build tools, to be able to comply
65+ with these guidelines. THe most IDEs have a intelligent code inspection
6666 engine, with some configuration, already supporting many aspects of the
6767 Coding Guidelines.
6868
@@ -73,10 +73,10 @@ In the last years I often created some kind of code styles and coding
7373guidelines, which I used in both, private and professional projects. Now I
7474would like to use this knowledge to write some general guidelines.
7575
76- ## Is this a official coding standard?
76+ ## Is this an official coding standard?
7777Definitely not! This document does not state that projects must comply with
7878these guidelines, neither does it say which guidelines are more important than
79- other . It is intended to be a guide for anyone who does not want to deal with
79+ others . It is intended to be a guide for anyone who does not want to deal with
8080creating own rules but still wants to have a homogeneous developer experience
8181within one team, but also across multiple teams.
8282
0 commit comments