Added some nice quotes. Added more TODO sections
This commit is contained in:
@@ -1,5 +1,9 @@
|
||||
\chapter{\tr{Programming style}{Programmierstil}}
|
||||
|
||||
\shortquote{Any code of your own that you haven't looked at for six or
|
||||
more months might as well have been written by someone
|
||||
else.}{Eagleson's law}
|
||||
|
||||
Guter Programmierstil ist keine Frage des guten Geschmacks sondern des
|
||||
Verst\"andnisses von Programmcode und ein Baustein in dem Bestreben
|
||||
wissenschaftlichen Erkenntnisgewinn reproduzierbar zu
|
||||
@@ -67,7 +71,7 @@ aktuellen Ordner nach passenden Dateien sucht (mehr Information zum
|
||||
\matlab-Suchpfad in Box~\ref{matlabpathbox}).
|
||||
|
||||
\begin{figure}[tp]
|
||||
\includegraphics[width=0.82\textwidth]{program_organization}
|
||||
\includegraphics[width=0.75\textwidth]{program_organization}
|
||||
\titlecaption{\label{fileorganizationfig} M\"ogliche Organisation von
|
||||
Programmcode im Dateisystem.}{ F\"ur jedes Projekt werden
|
||||
Unterordner f\"ur die einzelnen Analysen angelegt. Auf Ebene des
|
||||
@@ -271,6 +275,10 @@ ein v\"ollig unn\"otiger Kommentar.
|
||||
\item Ein falscher Kommentar ist schlimmer als gar kein Kommentar!
|
||||
\item Kommentare m\"ussen gepflegt werden, sonst sind sie wertlos!
|
||||
\end{itemize}
|
||||
\widequote{Good code is its own best documentation. As you're about to add
|
||||
a comment, ask yourself, ``How can I improve the code so that this
|
||||
comment isn't needed?'' Improve the code and then document it to
|
||||
make it even clearer.}{Steve McConnell}
|
||||
\end{important}
|
||||
|
||||
\pagebreak[4]
|
||||
@@ -418,7 +426,16 @@ werden. Wenn diese nicht von globalem Interesse sind, kann mit
|
||||
\codeterm[Funktion!geschachtelte]{geschachtelten
|
||||
Funktionen} die \"Ubersichtlichkeit erh\"oht werden.
|
||||
|
||||
\noindent Es lohnt sich auf den eigenen Programmierstil zu
|
||||
achten!\footnote{Buchtip: Robert C. Martin:
|
||||
\textit{Clean Code: A Handbook of Agile Software Craftmanship},
|
||||
Prentice Hall}
|
||||
Es lohnt sich auf den eigenen Programmierstil zu
|
||||
achten!\footnote{Buchtip: Robert C. Martin: \textit{Clean Code: A
|
||||
Handbook of Agile Software Craftmanship}, Prentice Hall}
|
||||
|
||||
\shortquote{Programs must be written for people to read, and only
|
||||
incidentally for machines to execute.}{Abelson / Sussman}
|
||||
|
||||
\shortquote{Any fool can write code that a computer can
|
||||
understand. Good programmers write code that humans can
|
||||
understand.}{Martin Fowler}
|
||||
|
||||
\shortquote{First, solve the problem. Then, write the code.}{John
|
||||
Johnson}
|
||||
|
||||
Reference in New Issue
Block a user