Softwareprojekte dokumentieren im Beruf

Kann man glaub ich nicht verallgemeinern, zumindest bei mir.
Es gibt massig kleinere Projekte, da ist so gut wie nichts an Doku da. 
Ein Programmablaufplan, ein halbwegs gut kommentierter Quelltext und 
aussagekräftige Variablennamen - fertig.
Wer damit nicht zurecht kommt - Beruf verfehlt.
Gibt natürlich auch Kunden, die wollen selbst für Kleinkram eine 
komplette Doku haben. Wird dann extra angeboten und kostet extra.
Unter Kleinkram verstehe ich all die Projekte, die mit einem einzigen 
Controller arbeiten, auf denen ein einziges Programm läuft und die nicht 
vernetzt sind.

Hab bisher keine Hardwareprojekte umgesetzt, sondern war nur ein wenig 
im Web-Bereich tätig, hoffe dass dir das trotzdem hilft.

Wir hatten mal ein großes Projekt für eine internationale NGO am laufen 
bei dem wir nicht mit SVN oder sowas gearbeitet hatten. Wir waren 2 
Programmierer (+1 "Chef") jeder hatte den Stand auf dem Rechner und hat 
ihn hin und wieder ins Testsystem hochgeladen. Erstmal schien das auch 
gut zu gehen. Hatte mir aber sicherheitshalber selbst einige 
Zwischenversionen gesichert.
Es verging einige Zeit und der andere Programmierer wurde nicht fertig 
bzw. hatte schwere Bugs im System. Zuerst sollte er sie noch selbst 
fixen, letztendlich bliebs dann bei mir hängen.
Ich musste mich erstmal in seinen grauenhaften Code einarbeiten. 
Dutzende Dateien von denen man nie wusste ob die noch gebraucht werden 
oder nicht (z.B. sowas wie answers.php, answers00.php, answers01.php 
answers_user.php usw, und die Namen gabs in 3 verschiedenen Ordnern)
Keine Versionsverwaltung und auch keine Doku, der Code selbst war 
grauenhaft programmiert und funktioniert oft nur zufällig! Irgendwie hab 
ich mich dann da durchgewurschtelt, hab auch noch weitere Bugs entdeckt 
usw.
Richtig zurecht gekommen bin ich damit nie, das System funktionierte 
hernach mehr schlecht als recht.
Dann gabs ein Krisentreffen mit dem Auftragsgeber aufgrund der 
Verzögerungen, man wollte neue Programmierer ins Team schicken, der 
andere Programmierer hat aufgehört (wurde ihm vermutlich auch 
nahegelegt...).
Der Auftragsgeber fragte uns dann, wie wir weiter mit dem System 
verfahren wollen was bisher aufgebaut wurde. Ich sagte ihnen dann 
ehrlich, dass ich keine Chance sehe diesen verbuggten Code jemals zum 
laufen zu bekommen, und dass wir diesen Teil neu schreiben sollten. 
Letztendlich bekamen wir einen Ersatzprogrammierer und ich installierte 
noch SVN. Da mein Code einigermaßen strukuriert war und gut lief blieb 
er zu 95% erhalten, der restliche Code wurde komplett herausgenommen.
Mit dem neuen Programmierer kam ich gut zurecht, wir nutzten indefero 
für die Bugverwaltung. Es gab wieder große Fortschritte im Projekt.
Eine Doku wurde trotzdem nicht angelegt bzw. es wurde ein paar mal 
halbherzig angefangen und dann wieder stehen gelassen. Dennoch kann man 
sich gut im Code zurechtfinden, da er ordentlich programmiert ist.
Das System wurde dann auch fertiggestellt. Zwischen drin wars aber immer 
wieder ein Problem die Finanzierung zu sichern, da kaum was 
funktionierte und die NGO natürlich nur von außen irgendwelche Gelder 
bekommt. Zum Einsatz kam das System nie. Die NGO wurde umstrukturiert 
und das (fertige) System nicht mehr benötigt, vermutlich auch wieder 
eine Geldsache.

Daraus hatte unser Chef (der nichtmal selbst wirklich programmieren 
kann...) gelernt, dass Versionsverwaltung + anständiger Code sinnvoll 
ist.
Darauf geachtet wurde trotzdem nicht, er hat sich nie mit meinem Code 
beschäftigt. Bei den nächsten (zum Glück kleineren) Projekten wurde das 
so fortgeführt. Meistens war auch zeitdruck dabei, d.h. eine Doku gabs 
auch hier wieder nicht.
Eine Gefahr ist auch, dass man ein einfaches Grundsystem programmiert 
hat das übersichtlich ist. Dann kommt aber der Chef daher und will noch 
dieses und jedes Feature haben. Beim nächsten Kunden: Ja nimm das alte 
System und programmiere noch Dies und Jenes dazu. Nach und nach bläht 
sich der Code dann auf, wenn man 10 und mehr Kunden nacheinander hatte, 
für die man das alte System nur immer anpasst.
Mittlerweile denke ich, dass der Code für außenstehende nicht mehr 
wartbar ist. Ich selbst finde mich drin noch zurecht, andere haben da 
keine Chance. Natürlich hätte ich alles besser strukturieren können. 
ABER: Ich wurde pauschal bezahlt, d.h. X00€ für dieses Projekt wenns 
fertig ist. Und am besten sollte es z.B. in 3 Tagen stehen.
1. Lässt die Zeit es nichtmal zu dass man das System schön durchtestet
2. Lässt es die Zeit damit erst recht nicht zu guten Code zu produzieren
3. Lässt die Zeit erst recht keine Doku zu
Hab die Sache auch ein paar mal beim Chef angesprochen bzgl. 
Programmierstil usw., aber wirklich vorangegangen ist da nicht. Würde 
eben auch wieder Geld kosten.

Hab mich mittlerweile von dem Laden verabschiedet und hab jetzt selbst 
was eigenes. Jetzt wird alles schön ins SVN hochgeladen und 
übersichtlicher Code geschrieben. Dazu zählt z.B. auch, dass man 
objektorientiert Programmiert, das macht den Code verständlicher.
Ehrlich gesagt dokumentiere ich auch nicht viel, ich versuche eher den 
Code so zu halten, dass er auch ohne Doku verständlich ist. Das klappt 
sehr gut, man findet sich schnell zurecht.