Was gehört alles in eine richtige Dokumentation?

[MaBuSE]

Zitat von Furtbichler:

Also, ich würde mal sagen, der Name 'SetEnabledRec' ist Schrott. Im Clean-Code sollte er so heißen (z.B.):
SetEnabledOfChildControlsOnForm(aForm : TComponent; aParentControl : TControl; aValue : Boolean); Wozu also jetzt noch Kommentare?

Ich möchte dazu nur folgendes sagen:

1. Hat r2c2 das in seinem sehr ausführlichen Beitrag schon wirklich nett erklärt.
2. In Deinem Namen nicht erkennbar ist, dass rekursiv die Eigenschaft Enabled aller untergeordneten Elemte gesetzt werden.
3. Habe ich geschrieben, warum das so ist, und ich auch nicht glücklich damit bin.
4. Werden die Kommentare zur Erstellung der Dokumentation verwendet.
   Und ich bin immer noch der Meinung, dass in der Beschreibung einer API auch eindeutige Funktionen dokumentiert werden sollten.
   z.B. die Funktion abs()-> http://docwiki.embarcadero.com/Libra.../de/System.Abs