Updated Datenübernahme vom CVS in Git (markdown)
[thera-pi-2.wiki.git] / Verbesserungen-Organisation.md
blob5de3da4d6ad996f8a5c6131040fff0a09dcc67ef
1 Gewisse Arbeitsweisen erleichtern die Teamarbeit.
3 Für eine gemeinsame Softwareentwicklung oder für eine spätere Übernahme von vorhandenem Code ist ein gewisses Verständnis erforderlich. Dafür sollte der Code möglichst selbstdokumentierend geschrieben und ausreichend dokumentiert sein. Das "Was wird gemacht" sollte aus dem Code leicht erkennbar sein, ergänzt durch Kommentare "Warum wird das (so) gemacht".
5 Code-Änderungen sollten nachvollziehbar und dokumentiert sein: zusammengehörige Änderungen in kleinen Commits mit Kommentar, unabhängige Änderungen separat. Wenn man später sehen kann, an welchen Stellen für eine bestimmte Korrektur oder Erweiterung geändert wurde, kann man ähnliche Änderungen leichter ausführen.
6 Große Commits mit mehreren verschiedenen Änderungen sind kaum nachvollziehbar.
8 Parallelarbeit ermöglichen.
9 * In der Sourcecode-Verwaltung (CVS) sollte immer ein relativ aktueller und vollständiger Stand verfügbar sein, damit auch andere Entwickler sich beteiligen können.
10 * Kleine Commits erleichtern die Auflösung eventueller Konflikte.
11 * Branches für Entwicklung verschiedener Erweiterungen oder Korrekturen verwenden und in den Trunk integrieren.
12 * Eventuell auf andere Sourcecode-Verwaltung (Git?) umsteigen, um die Teamarbeit zu erleichtern.
14 Build-Ablauf automatisieren und Erstellung eines Installationspakets allein aus Entwicklungsumgebung ohne Zugriff auf lokal installierte Anwendung. Damit soll eine reproduzierbare Erstellung von Dateien und Installationspaketen ermöglicht werden.
16 Versionen in der Sourcecode-Verwaltung kennzeichnen. Damit wäre die Bereitstellung von Altversionen möglich, wenn dies einmal erforderlich ist, siehe Frage im Forum, ob irgendjemand noch eine Version vom xx.xx.xx hat.
18 Anfrage bei BitRock, ob man statt einer Festlegung auf einen einzigen Namen eine Festlegung auf einen Präfix haben könnte. Die Installation von Bibliotheken und TheraPi unter dem gleichen Namen bringt wahrscheinlich die Software-Verwaltung von Windows und vielleicht auch die Anwender durcheinander.