Skip to content

Commit 39b823b

Browse files
authored
Merge pull request #14 from ManticSic/fix-wording
Fix several issues
2 parents 5db8e91 + 6caf3c7 commit 39b823b

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

coding-guidelines/docs/index.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -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
2929
okay.
3030

3131
There 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
5353
future issues, it es very likely the wrong solution and needs redesign. The
5454
worst 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
7373
guidelines, which I used in both, private and professional projects. Now I
7474
would 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?
7777
Definitely not! This document does not state that projects must comply with
7878
these 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
8080
creating own rules but still wants to have a homogeneous developer experience
8181
within one team, but also across multiple teams.
8282

0 commit comments

Comments
 (0)