Habe am Wochenende und heute mal endlich mit meinem Projekt weitergemacht!
Das ist echt hart: Wenn man ein paar Wochen nicht im Code war, dauert’s echt Ewigkeiten um zu verstehen, was man da eigentlich gemacht hat 😉 Deswegen habe ich mich jetzt entschlossen PEAR::PHPDocumentor einzusetzen, was voraussetzt, dass ich vernünftig kommentiere (halt nach dem JavaDoc-Standard).
Habe mir auch PHPDoc angeschaut, aber da kommen ewig viele Fehler bei raus und es ist auch umständlicher zu konfigurieren. Da ich bislang mit den PEAR-Paketen gut gefahren bin, nutze ich also nun das entsprechende Dokumentationspaket.
Des Weiteren habe ich die Programmierung auf rein englische Schreibweise umgestellt (was am Wochenende mal eben nen ganzen Tag gedauert hat ;)). Es ist zwar komisch, die altvertrauten versicherungsmathematischen Begriffe wie Alterungsrückstellung, Grundwert und Kommutationswert auf einmal englisch zu schreiben, aber ich denke es macht so mehr her und die Methodennamen á la “getAllGrundwerte()” sehen ja auch nicht sooo toll aus 🙂
Zur Zeit sitze ich also an der Neustrukturierung des vorhandenen Codes… hätte ich keine so lange Pause gehabt, wäre das sicher nicht notwendig gewesen, aber auf der anderen Seite kann ich so jetzt Dinge einbauen und verwenden, die ich vorher nicht kannte. Bin also eigentlich ganz froh drum!