Wenn man mit CodeGenerierungsTools arbeitet, um vielleicht eine technische Doku zu erstellen, macht es schon Sinn so viel wie möglich zu kommentieren, insbesondere um einfach mehr Semantik an den Konsumenten beispielsweise einer Serviceschnittstelle oder an einem Entwickler der die Methode verwenden soll, zu bringen.

Ich sehe auch einen Mehrwert darin, wenn man etwas Beispielcode, wie man denn eine (komplexe) Methode / Operation verwenden kann, mit einbringt.

Hier geht es auch darum, das du deinen Code - eben auch ein paar Monate später - schnell wieder rein findest und dann auch sogleich verstehst, wenn mal eine Änderung oder Erweiterung ansteht.

Wenn man mit CodeGenerierungsTools arbeitet, um vielleicht eine technische Doku zu erstellen, macht es schon Sinn so viel wie möglich zu kommentieren, insbesondere um einfach mehr Semantik an den Konsumenten beispielsweise einer Serviceschnittstelle oder an einem Entwickler der die Methode verwenden soll, zu bringen.

Ich sehe auch einen Mehrwert darin, wenn man etwas Beispielcode, wie man denn eine (komplexe) Methode / Operation verwenden kann, mit einbringt.

Hier geht es auch darum, das du deinen Code - eben auch ein paar Monate später - schnell wieder findest und dann auch sogleich verstehst, wenn mal eine Änderung oder Erweiterung ansteht.