IMHO, wenn Sie nur eines tun könnten, bevor Sie Ihr Projekt übergeben (entweder direkt oder indirekt), würde ich empfehlen, dass Sie doppelt und dreifach überprüfen, ob es so wie es ist aus der Quellcodeverwaltung kompiliert wird.
Kein Lachen, aber ich kann Ihnen nicht sagen, wie oft ich "neueste" von einer Quellcodeverwaltung erhalten habe und sie nicht kompiliert werden konnte, nur um später herauszufinden, dass ich nicht "auf Freds alter Box" war, weil anscheinend nur der Code " kompiliert auf Freds alter Box ". Ich hatte sogar einen ehemaligen Arbeitgeber, der meinen Desktop sofort aus meinem Cube entfernte und durch "Freds alte Box" ersetzte, damit ich an dem Projekt arbeiten konnte, für das ich mich entschieden hatte.
Als Erweiterung der obigen Empfehlung empfehle ich, dass Sie eine README.txt erstellen und im Stammverzeichnis Ihrer Anwendung ablegen und diese in die Quellcodeverwaltung einfügen, da manchmal nicht das Neueste zum Kompilieren einer Anwendung erforderlich ist. Dieses README-Dokument sollte eine Liste externer Abhängigkeiten enthalten, die nicht in die Quellcodeverwaltung eingecheckt werden konnten (falls vorhanden), die Einrichtung der Datenbank und andere Besonderheiten hinsichtlich der Kompilierungs-, Ausführungs- oder Bereitstellungszyklen der Anwendung.
Alles, was über die beiden oben genannten Vorschläge hinausgeht, wäre nur Sauce, aber meiner Meinung nach sind die beiden oben genannten fast für jedes Projekt erforderlich, das größer als "Hello World" ist.
BEARBEITEN:
Zum Thema Dokumentation ...
Im Laufe der Jahre habe ich meinen Teil der Softwaredokumentation geschrieben und gelesen, um den Übergang eines Entwicklers zu erleichtern. Ich würde sagen, dass solche Dokumente selten das Papier wert sind, auf dem sie gedruckt werden. Entwickler (ich selbst eingeschlossen) denken beim Schreiben solcher Dokumente selten an die wichtigen Teile der Anwendung. Wir denken nur an die jüngsten Brände, gegen die wir gekämpft haben. Abgesehen von der Tatsache, dass diese Dokumente in der Regel nicht alle wichtigen Aspekte der Software abdecken, sind sie auch SEHR schnell veraltet. Sobald das Dokument veraltet ist, wird ein zukünftiger Entwickler es höchstwahrscheinlich völlig ignorieren, anstatt es wieder der Realität anzupassen (denken Sie an sich ändernde Anforderungen).
Anstelle der Dokumentation an sich empfehle ich Unit-Tests. Ich weiß, dass es an dieser Stelle wahrscheinlich alt klingt, aber lassen Sie den Code die Dokumentation für Sie erledigen. Defekte Komponententests sind schwer zu ignorieren (und leichter zu erkennen) als ein Word-Dokument. Darüber hinaus ist die englische Sprache fürchterlich ungenau, um die Feinheiten des Software-Designs zu artikulieren. Es gibt einfach zu viele Möglichkeiten, die Bedeutung selbst der einfachsten englischen Sätze zu interpretieren, und dies führt nur zu Verwirrung und / oder Fehlern.