<![CDATA[Nützliche Programm Doku unmöglich?]]>Gibt es keine Möglichkeit eine Doku für ein Programm so zu schreiben, dass man es schnell ändern oder erweitern kann? Ich hab noch nie eine gesehen. Entweder es gibt garnichts oder gleich wieder ganze "Bücher". Aber wer will den 200 Seiten lesen, nur weil er an nem Programm was ändern soll?
Ich mein jetzt nicht Dokus für Frameworks, sondern für selbst entwickelte Programme.

]]>https://www.c-plusplus.net/forum/topic/170849/nützliche-programm-doku-unmöglichRSS for NodeTue, 07 Jul 2026 04:25:39 GMTSat, 20 Jan 2007 09:47:19 GMT60<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 09:47:19 GMT]]>Gibt es keine Möglichkeit eine Doku für ein Programm so zu schreiben, dass man es schnell ändern oder erweitern kann? Ich hab noch nie eine gesehen. Entweder es gibt garnichts oder gleich wieder ganze "Bücher". Aber wer will den 200 Seiten lesen, nur weil er an nem Programm was ändern soll?
Ich mein jetzt nicht Dokus für Frameworks, sondern für selbst entwickelte Programme.

]]>https://www.c-plusplus.net/forum/post/1213072https://www.c-plusplus.net/forum/post/1213072Sat, 20 Jan 2007 09:47:19 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 09:54:30 GMT]]>Die beste Dokumentation sind die Kommentare in einem Quellcode; sind diese gut, so braucht man als "erweiterte Dokumentation" höchstens einige Diagramme u. Erläuterungen, um den Überblick zu behalten.

]]>https://www.c-plusplus.net/forum/post/1213074https://www.c-plusplus.net/forum/post/1213074Sat, 20 Jan 2007 09:54:30 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 11:35:32 GMT]]>Javadoc ftw 🙄

]]>https://www.c-plusplus.net/forum/post/1213105https://www.c-plusplus.net/forum/post/1213105Sat, 20 Jan 2007 11:35:32 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 12:32:03 GMT]]>Was hab ich den von dokumentiertem Code, wenn ich ein fremdes Programm ändern soll? Soll ich dann erst mal die Hälfte des Codes lesen, bis ich die passende Stelle gefunden hab.

Nur weil ich Javadoc verwende muss die Doku noch lange nicht gut sein. 🙄

]]>https://www.c-plusplus.net/forum/post/1213131https://www.c-plusplus.net/forum/post/1213131Sat, 20 Jan 2007 12:32:03 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 12:49:26 GMT]]>kommentator schrieb:

Was hab ich den von dokumentiertem Code, wenn ich ein fremdes Programm ändern soll? Soll ich dann erst mal die Hälfte des Codes lesen, bis ich die passende Stelle gefunden hab.

Mein Post nochmal lesen -> Nachdenken -> Aha-Effekt erleben.

kommentator schrieb:

Nur weil ich Javadoc verwende muss die Doku noch lange nicht gut sein. 🙄

Und ... ?

]]>https://www.c-plusplus.net/forum/post/1213143https://www.c-plusplus.net/forum/post/1213143Sat, 20 Jan 2007 12:49:26 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 12:56:19 GMT]]>Reyx schrieb:

als "erweiterte Dokumentation" höchstens einige Diagramme u. Erläuterungen, um den Überblick zu behalten.

Das sagt garnichts aus. Wie sollen den die Diagramme aussehen, dass man alles genau findet? Wenn du ein Programm hast das aus mehreren 1000 Klassen besteht, dann hast du wieder so ein kleines Buch voller Diagramme und kommst doch nirgens hin.

]]>https://www.c-plusplus.net/forum/post/1213148https://www.c-plusplus.net/forum/post/1213148Sat, 20 Jan 2007 12:56:19 GMT<![CDATA[Reply to Nützliche Programm Doku unmöglich? on Sat, 20 Jan 2007 14:56:57 GMT]]>Bei einem vernünftigen Entwurf stehen diese 1000 Klassen aber nicht wahllos in einem beliebigen Kontext. Für gewöhnlich kannst Du selbst große Anwendungen in Teilsysteme einteilen. Die Diagramme zeigen Dir dann entsprechend nur einen Ausschnitt. Divide and Conquer halt...
Natürlich musst Du über gewisse Informationen in den Diagrammen abstrahieren (sprich sie ausblenden), um sie möglichst kompakt zu halten und den Überblick zu behalten.

]]>https://www.c-plusplus.net/forum/post/1213207https://www.c-plusplus.net/forum/post/1213207Sat, 20 Jan 2007 14:56:57 GMT