diff --git a/CHANGELOG b/CHANGELOG
index 036e567..d9ac93f 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,4 +1,15 @@
 Release: next
+- write usable version of user guide.
+- partially fix orphaned section headers for singualar use of \section and \subsection
+  commands and give users the new adjustable lengths \cvsectionstretchability
+  and \subsectionstretchability. In case \section and \subsection are used
+  directly one after the other, an orphaned section header might still occur. 
+  This is structural and should be solved by \newpage instead of increasing 
+  \cvsectionstretchability. Closes #10. 
+- Systematize colors and make them user adjustable. See documentation for details. 
+  this requires the \moderncvcolor to be issued BEFORE \moderncvstyle.
+- all styles: make the head options 'details' and 'nodetails' available to the user. (previously they were hidden). Olystyle does not respond too well to nodetails.
+- casual style: make the head options 'alternate', 'details' and 'nodetails' available to the user. (previously they were hidden).
 - fix Researcher ID (still) doesn't display Issue #29.
 - make options 'symbols' and 'nosymbols' available to all styles to toggle whether 
   symbols should be used or not. Include symbols in oldstyle by default. 
diff --git a/manual/moderncv_userguide.tex b/manual/moderncv_userguide.tex
index 7a4c352..2fdb094 100644
--- a/manual/moderncv_userguide.tex
+++ b/manual/moderncv_userguide.tex
@@ -545,7 +545,8 @@ Some length adjustments can be made to the skill matrix and will be explained in
 
 \subsection{Letter of motivation}
 
-\todox{add short explanation of motivation letter. Maybe add instructions on how to insert a scanned signature}
+\todo{add short explanation of motivation letter.}
+To add a subject to the letter of motivation or close with your signature see sections \ref{section:add:subject} and \ref{section:add:signature}
 
 
 
@@ -865,6 +866,59 @@ The penalties must be between -100 and 9999. The higher the value the less likel
 
 
 \subsection{Tips and Tricks}
+\subsubsection{Including a scanned signature in letter of motivation}
+\label{section:add:signature}
+In case one wishes to add a scanned signature to the letter of motivation, place the following into your praeamble
+%%%% redefinition of makeletterclosing without printing Name and last name but inserting
+%%%% a signature png instead.
+\begin{lstlisting}
+  \makeatletter
+  \renewcommand*{\makeletterclosing}{
+    \@closing\\[3em]%
+    \includegraphics[height=1.5cm,width=5.5cm]{<signature.png>}
+    %   {\bfseries \@firstname~\@lastname}%
+    \ifthenelse{\isundefined{\@enclosure}}{}{%
+      \\%
+      \vfill%
+      {\color{color2}\itshape\enclname: \@enclosure}}}
+  \makeatother
+\end{lstlisting}
+
+\subsubsection{Including a subject in letter of motivation}
+\label{section:add:subject}
+In case you want to add a subject to you letter of motivation, add the following in the praeamble
+\begin{lstlisting}
+  %%%% redefine letterhead to add subject line
+  \makeatletter
+  \renewcommand*{\makeletterhead}{%
+    % recompute lengths (in case we are switching from letter to resume, or vice versa)
+    \recomputeletterlengths%
+    % recipient block
+    \begin{minipage}[t]{.5\textwidth}
+      \raggedright%
+      \addressfont%
+      {\bfseries\upshape\@recipientname}\\%
+      \@recipientaddress%
+    \end{minipage}
+    % date
+    \hfill% US style
+  %  \\[1em]% UK style
+    \@date\\[4em]% US informal style: "January 1, 1900"; UK formal style: "01/01/1900"
+    % opening
+    \raggedright%
+    {\bfseries\subject}\\[2em]
+    \@opening\\[1.5em]%
+    % ensure no extra spacing after \makelettertitle due to a possible blank line
+  %  \ignorespacesafterend% not working
+    \hspace{0pt}\par\vspace{-\baselineskip}\vspace{-\parskip}
+    }
+  \makeatother
+\end{lstlisting}
+The a subject can thereafter be added to the letter of motivation by 
+\begin{lstlisting}
+  \subject{<subject_text>}
+\end{lstlisting}
+
 \subsubsection{Legal disclaimer at the end of CV}
 Some countries (e.g. Italy) require to add the permission to treat the personal data contained in the CV. This can be achieved by the command \code{\\vfill}. At the end of the last entry to your 
 CV, add the following:%