Entwicklerleitfaden / Leitfaden Codestyle
- 1 Allgemeine Hinweise
- 2 General references
- 3 Codeelemente .NET
- 4 Codeelemente Python
- 5 Code elements .NET (engl.)
- 6 Code elements Python (engl.)
- 7 Leitfaden View-Kommentare
- 8 View Comments Guide (engl.)
- 9 Leitfaden XML-Kommentare
- 10 XML Comments Guide (engl.)
- 11 Leitfaden für Commit Kommentare innerhalb der Versionsverwaltung
- 12 Commit comments guide within version management (engl.)
- 13 Abhängigkeiten/Dependencies
- 14 Dependencies (engl.)
Allgemeine Hinweise
Sprechende Namen verwenden
Zeilenumbruch nach Operator, Komma; Einrücken nach Zeilenumbruch
Leerzeilen verwenden, um logische Einheiten voneinander zu trennen und Deklarationen von Anweisungen abzusetzen
keine ungarische Notation
General references
use significant names
Line break after operator, comma; indent after line break
Use blank lines to separate logical units from each other and to declare statements
no Hungarian notation
Codeelemente .NET
Codeelement | Sprache | Schreibweise | Hinweise & Beispiele |
|---|---|---|---|
Klasse | Engl. | PascalCase | Eine Klasse pro Datei |
Darstellung | Aufbau von Klassen, Klassen/Interface-Deklaration, Felder, Properties, Konstruktor, Methoden. | ||
Interface | Engl. | PascalCase | public IMyInterface |
Feldname | Engl. | PascalCase | public String InvNumber {get; set; } |
Methode | Engl. | PascalCase | public void Calculation |
Variable | Engl. | CamelCase | String invoiceNumber |
Instanzvariable | Engl. | CamelCase | private String invoiceNumber |
Parameter | Engl. | CamelCase | DoCalculation(int cntPos, decimal pricePos) |
Konstanten | Engl. | PascalCase | const int NumDaysOfWeek = 4 |
Events | Engl. | PascalCase | MouseEventHandler(object sender, MouseEventsArgs e) |
GUI | Dt. | PascalCase | |
Komponente | Engl. | PascalCase | |
DB-Tabelle | Engl. | Lowercase | public String eq_invNumber {get; set; } |
DB-Spalte | Engl. | Kleinschreibung | lastname_new |
Kommentare | Dt. / Engl. | - | Bei neuralgischen Punkten in Englisch kommentieren |
Codeelemente Python
Codeelement | Sprache | Schreibweise | Hinweise & Beispiele |
|---|---|---|---|
Klasse | Engl. | Lowercase | Eine Klasse pro Datei |
Darstellung | Engl. | Aufbau von Klassen, Klassen/Interface-Deklaration, Felder, Properties, Konstruktor, Methoden | |
Feldname | Engl. | Lowercase | eq_invnumber |
Methode | Engl. | Lowercase | def myfunction(self): |
Variable | Engl. | Lowercase | eq_invoicenumber |
Instanzvariable | Engl. | Lowercase | _eq_invoicenumber |
Parameter | Engl. | Lowercase | sprechende Namen verwenden |
Konstanten | Engl. | Uppercase | CONST_DATA = 4 |
DB-Tabelle | Engl. | Lowercase | eq_datatable oder eq_data.table (eq_ Präfix) |
DB-Spalte | Engl. | Lowercase | eq_lastname (eq_ Präfix) |
Kommentare | Dt. / Engl. | - | Bei neuralgischen Punkten in Englisch kommentieren |
Code elements .NET (engl.)
Code element | Language | Diction | References & Samples |
|---|---|---|---|
Class | engl. | PascalCase | One class per file. |
View | engl. | - | Structure of classes, class/interface declaration, fields, properties, constructor, methods. |
Interface | engl. | PascalCase | public IMyInterface |
Field name | engl. | PascalCase | public String InvNumber {get; set; } |
Method | engl. | PascalCase | public void Calculation |
Variabel | engl. | CamelCase | String invoiceNumber |
Instance variable | engl. | CamelCase | private String invoiceNumber |
Parameter | engl. | CamelCase | DoCalculation(int cntPos, decimal pricePos) |
Constants | engl. | PascalCase | const int NumDaysOfWeek = 4 |
Events | engl. | PascalCase | MouseEventHandler(object sender, MouseEventsArgs e) |
GUI | ger. | PascalCase | |
Component | engl. | PascalCase | |
DB table | engl. | Lowercase | public String eq_invNumber {get; set; } |
DB column | engl. | Lowercase | lastname_new |
Comments | ger. / engl. | CamelCase | Bei neuralgischen Punkten in Englisch kommentieren |
Code elements Python (engl.)
Code element | Language | Diction | References & Samples |
|---|---|---|---|
Class | engl. | Lowercase | One class per file. Use the eq_{classname} prefix |
View | Structure of classes, class/interface declaration, fields, properties, constructor, methods | ||
Field name | engl. | Lowercase | eq_invnumber |
Method | engl. | Lowercase | def myfunction(self): |
Variabel | engl. | Lowercase | eq_invoicenumber |
Instance variable | engl. | Lowercase | _eq_invoicenumber |
Parameter | engl. | Lowercase | use significiant names |
Constants | engl. | Uppercase | CONST_DATA = 4 |
DB table | engl. | Lowercase | eq_datatable or eq_data.table (eq_ prefix) |
DB column | engl. | Lowercase | eq_lastname (eq_ prefix) |
Comments | ger. / engl. | - | In areas where difficulties may occur use english |
Leitfaden View-Kommentare
Element | Benennung |
|---|---|
Label | lbl {name} |
Text | txt {name} |
Checkbox | cbx {name} |
Div | div {name} |
Dropdown | ddl {name} |
Button | btn {name} |
Table | tbl {name} |
Radiobutton | rdb {name} |
Image | img {name} |
View Comments Guide (engl.)
Element | Naming |
|---|---|
Label | lbl {name} |
Text | txt {name} |
Checkbox | cbx {name} |
Div | div {name} |
Dropdown | ddl {name} |
Button | btn {name} |
Table | tbl {name} |
Radiobutton | rdb {name} |
Image | img {name} |
Leitfaden XML-Kommentare
XML Tag | Klasse | Methode | Feld | Beschreibung / Beispiel |
|---|---|---|---|---|
<summary> | x | x | x | Eine Zusammenfassung des Objekts |
<returns> | x |