Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Tipps für die Zusammenarbeit am Quellcode  


Tip

Gerne möchte ich Euch animieren, alle notwendigen Informationen im Quellcode Header einer Implementierungsdatei am Laufen zu halten. Dies trägt einer formellen und chronologisch sauberen ersichtlichen Mitarbeit an der jeweiligen ausgekoppelten Implementierung bei. Ebenso setzt Ihr so, die Rahmenbedingungen, wie Rechtevergabe, Zusammenarbeit und Veränderungen vollzogen werden. Lasst uns professionell implementieren!

Aufbau des Datei Headers

Image Added


Tip

Grundsätzlich verwenden wir als Indentation Style (Einrückung) den Tabulator mit der Weite (4). Bitte keine Spaces (Leerzeichen) verwenden. Erlaubt sind Leerzeichen jedoch, um fehlende Zeichenweiten kleiner 4 Leerzeichen aufzufüllen, zum Beispiel um 2 Operatoren [+, - , * , /] nach einem Umbruch untereinander bündig darstellen zu können.

Namespace und Tabulator Einrückung

Abbildung 1

Tip

Wie in der Abbildung darüber zu sehen, sollten die Kommentar Blöcke an der linken Seite bündig beginnen. Der Namespace oben sollte zusammen mit using einen Tab nach rechts verschoben werden.

Kommentare & Umbruch

Abbildung 2

Tip

Kommentare beginnen einen Tab Einzug früher und sollten bündig mit dem Quellcode sein. Die maximale Zeilenbreite liegt bei 130 Zeichen, dann sollte spätestens ein Umbruch erfolgen.

Korrekte Formatierung

Abbildung 3

Tip

So wie hier zusehen, sollten grundsätzlich auch Kommentare nicht über die 130iger Seitenbegrenzung geschrieben werden. Bei einem Umbruch sollten die Funktionsoperatoren [+, - , * /], dann links bündig die Funktion darstellen und möglichst nach einem Komma [,] umgebrochen werden.

Konvention Schlusszeile

Abbildung 4

Tip

Die Schlusszeile jeder Datei muss mit einer Leerzeile enden. Atlassians Sourcetree wirft sonst einen Fehler in gewissen Situationen.

Header Block & Updates

Abbildung 5

Tip

Der Header Block sollte wie im Bild aussehen. Insbesondere der Teil des Update Bereiches sollte gut ersichtlich und chronologisch mit dem Namen des Coders vermerkt sein.

Ordner Hierarchie & Abhängigkeiten

Abbildung 6

Tip

Noch ein Hinweis zur Ordner Struktur des Projektes. Sollte es unvermeidbar sein, Unity Abhängigkeiten auflösen zu müssen, so sollten diese entsprechenden Dateien, in der selben Order Struktur weiter unten im Verzeichnis UNITY und im entsprechendem Namespace ein gehangen werden. Wir haben damit einen Ort, die Abhängigkeiten zentralisieren zu können.



Panel

Auf dieser Seite:

Table of Contents



Tip

Zudem empfehle ich die Schriftart Source Code Pro mit einer festen Zeilenweite.



Zugehörige Seiten

Filter by label (Content by label)
showLabelsfalse
spacesUNITY
showSpacefalse
sorttitle
typepage
cqllabel = "documentation-space-sample" and type = "page" and space = "UNITY"
labelsdocumentation-space-sample