Ich finde POD Dokumentation mitten im code auch schrecklich.
Meistens erstelle ich die POD Doku ganz am Anfang und benutze sie erst als Konzept, und wenn ich fertig bin dann als richtige Dokumentation.

MfG