Geht es hier um Kommentare oder den strukturierten Aufbau einer Bibliothek?
@ehenkes:
1) doxygen ist schon ein Begriff, oder?
2) Was ist ein "Sendung mit der Maus"-Kommentar?
3) z.B MOTCO_I2C_ID: ID ist ok als Akü für Identifier, I2C sollte einem auch was sagen, aber MOTCO ist doch wieder eine strange Akü. Also was spricht denn da?
Ansonsten finde ich es gut, dass über Dokumention diskutiert wird. Auch im angeblich professionellen Bereich sieht es da meist schlecht aus. Deswegen finde ich Doxygen auch sehr gut, insbesondere wenn es so gut benutzt wird wie bei der Asuro-Dokumentation.
Wichtig ist bei einer guten Dokumentation meiner Meinung nach auch, die Absicht (das "Warum") rüberzubringen.
Gruß
Lisbeth