<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\begin{slide}{Code dokumentieren?}


warum?
\begin{itemize}\itemsep 0pt
\item nach innen (Implementierung)
\item nach außen (Schnittstelle)
\end{itemize}

wo?
\begin{itemize}\itemsep 0pt
\item intern (im Quelltext selbst)
\item extern (separates Dokument)
\end{itemize}

(Literatur: Steve McConnell, Code Complete 2)

\end{slide}

\begin{slide}{Abstand von Dokumenation und Code}

\dots je größer, desto gefährlicher!
(d. h. interne Dokumentation ist noch relativ sicher)

wenn möglich, externe Dokumente 
daraus durch Werkzeuge generieren.

warum nur unsicher: der Compiler kann zwar den Code
prüfen und ausführen, aber nicht die Kommentare.

Ideal: schreibe \emph{selbst-dokumentierenden} Code!

\end{slide}

</pre></body></html>