Jemand hat einmal gesagt, der Weg zur Hölle sei mit guten Absichten gepflastert. Wer genau das war, kann man wohl nicht so genau sagen - derjenige hatte aber sicherlich Recht.

Einer von Sams Kollegen etwa hatte einen gut gemeinten Hang dazu, hilfreiche Dokumentation in Code-Kommentare zu packen, aber... nun ja:

Protected Sub txtSSN_TextChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles txtSSN.TextChanged
	Try	' Ermöglicht Verfolgung von Fehlern
		'_______________________________________________________________________
		'
		' txtSSN_TextChanged
		'   Aktiviert durch Eingabe der Sozialversicherungsnummer
		'   Formulardaten an lokale Klassenvariable übetragen
		'_______________________________________________________________________
		'
		' anOrder.SSN
		'   Sozialversicherungsnummer zur Verarbeitung in allen Formularen speichern
		' txtSSN
		'   Formular-Objekt für eingegeben Sozialversicherungsnummer
		'
		'_______________________________________________________________________
		'
		anOrder.SSN = txtSSN.Text
	Catch ex As Exception	' Fehlerverfolgung.
		'_______________________________________________________________________
		'
		' Fehlermeldungen des Systems an den Benutzer unter dem Formulartitel 
		' anzeigen und Details an die Datenbank senden
		' send details to database
		'_______________________________________________________________________
		'
		subErrorReporting("txtSSN_TextChanged", ex.Message)
	End Try
End Sub

Wie man sieht gibt es hier nur eine Zeile echten Programmcodes hier. Davon abgesehen sollte wohl jeder Entwickler wissen, was "try", "catch" und "=" bedeuten.

(Übesetzt von Florian Heinle)