improve documentation, remove LaTeX warnings

1_introduction.tex

@@ -69,10 +69,22 @@ stattdessen die erste Zeile eines Absatzes eingerückt werden soll, kann mit
 \documentclass[noparskip]{agse-thesis}
 \end{lstlisting}
 
-Die Werte der drei o.g. Optionen können beliebig kombiniert werden:
+Die Dokumentensprache kann Deutsch oder Englisch sein (bitte mit Betreuer/in
+absprechen). Die Angabe der Sprache ist wichtig, damit \LaTeX\ u.a. die
+Silbentrennung und die Benennung von Überschriften und Bezeichnungen
+(für Abbildungen und Tabellen) richtig behandeln kann.
+\begin{lstlisting}[language={[LaTeX]TeX}]
+% Deutsch
+\documentclass[de]{agse-thesis}
+
+% Englisch
+\documentclass[en]{agse-thesis}
+\end{lstlisting}
+
+Die Werte der vier o.g. Optionen können beliebig kombiniert werden:
 \begin{lstlisting}[language={[LaTeX]TeX}]
 % Einstellung des Beispieldokuments
-\documentclass[serif,article,noparskip]{agse-thesis}
+\documentclass[serif,article,noparskip,de]{agse-thesis}
 \end{lstlisting}
 
 \subsubsection{Befehl \texttt{\textbackslash{}thesisTitle}}
@@ -97,7 +109,7 @@ Die Titelseite der Abschlussarbeit wird mit dem
 \texttt{\textbackslash{}coverpage}-Befehl erzeugt.
 Dessen Ausgabe wird über eine Reihe von Schlüssel-Wert-Paaren konfiguriert
 (siehe \autoref{tab:coverpage-config}).
-\begin{table}[h]
+\begin{table}[ht]
 \begin{center}
     \begin{tabular}{|l|L{5.5cm}|L{4cm}|}
         \hline

README.md

@@ -2,7 +2,8 @@
 
 ## Prerequisites
 
-You want to have the following things installed if you want to use this template:
+You want to have the following things installed if you intend to use this
+template:
  * A LaTeX backend (e.g. [TeX Live](https://www.tug.org/texlive) or [MikTeX](https://miktex.org))
  * A comfortable text editor (e.g. [Notepad++](https://notepad-plus-plus.org)) or a LaTeX frontend (e.g. [TeXstudio](http://www.texstudio.org))
  * A BibTeX manager (e.g. [JabRef](http://www.jabref.org))

agse-thesis.cls

@@ -72,6 +72,7 @@
 \fancyfoot{}
 \fancyfoot[C]{\thepage}
 \renewcommand{\headrulewidth}{0pt}
+\setlength{\headheight}{14pt}
 
 % Display Chapter and Section for book class
 \ifthenelse{\equal{\baseClass}{book}}{
@@ -87,10 +88,10 @@
 \usepackage[%
     pdfstartview=FitH,
     linktocpage,
-% two lines below = color links
+% two lines below = do color links
     colorlinks=true,
     citecolor=blue!20!black!30!green,
-% two lines below = don't color links
+% two lines below = don't color links at all
     %colorlinks=false,
     %pdfborder={0 0 0},
 ]{hyperref}
@@ -99,6 +100,10 @@
 \usepackage{tabularx}
 \newcolumntype{L}[1]{>{\raggedright\arraybackslash}p{#1}}
 
+% Lists
+\usepackage{enumitem}
+\setlist[itemize,1]{label=$\bullet$} % avoid font warning by ensuring math mode
+
 % Misc
 \RequirePackage{fancyref}
 \RequirePackage{url}

thesis.tex

@@ -3,11 +3,19 @@
 %===============================================================================
 % Font options are:
 %   plain (default), serif (uses Palladio), sans-serif (uses Paratype Sans)
+%
 % Layout options are:
 %   article (default, no chapters), book (for longer texts, offers \chapter)
+%   Changing this value between LaTeX runs may require deleting the .aux files
+%
 % Paragraph options are:
 %   noparskip (default, no spacing between paragraphs), parskip (spaced)
-\documentclass[serif,article,noparskip]{agse-thesis}
+%
+% Language options are:
+%   de (default), en
+%   Changing this value between LaTeX runs may require deleting the .aux files
+%
+\documentclass[serif,article,noparskip,de]{agse-thesis}
 
 % Global parameters, replace with actual values.
 \newcommand{\thesisTitle}{Über den Sinn des Lebens}
@@ -56,6 +64,7 @@
 \input{3_main}
 \input{4_conclusion}
 
+% Refers to file `bibliography.bib`
 \bibliography{bibliography}
 
 \appendix